home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / obskit.zip / OBSKIT.DOC < prev    next >
Text File  |  1992-01-11  |  208KB  |  5,606 lines
  1.    
  2.    
  3.    
  4.    
  5.    
  6.    
  7.                                Obs Toolkit (TM)
  8.    
  9.                                   User Manual
  10.    
  11.                                   Version 1.5
  12.    
  13.    
  14.    
  15.    
  16.    
  17.                              A DOS utility toolkit
  18.    
  19.                                       for
  20.    
  21.                          Command Line and Batch users
  22.    
  23.    
  24.    
  25.    
  26.    
  27.    
  28.                               _______
  29.                          ____|__     |                (R)
  30.                       --|       |    |-------------------
  31.                         |   ____|__  |  Association of
  32.                         |  |       |_|  Shareware
  33.                         |__|   o   |    Professionals
  34.                       -----|   |   |---------------------
  35.                            |___|___|    MEMBER
  36.    
  37.    
  38.    
  39.    
  40.    
  41.    
  42.                                 Contrails, Inc.
  43.                                  P.O. Box 2759
  44.                              Lompoc, CA 93438-2759
  45.    
  46.                                 CIS 71121,2426
  47.    
  48.    
  49.    
  50.                               Program created by
  51.                                Keith E. Robbins
  52.    
  53.    
  54.    
  55.                             Copyright (c) 1991 1992
  56.                               by Contrails, Inc.
  57.                               All rights reserved
  58.    
  59.    
  60.        Obs Toolkit 1.5                                             Dedication
  61.    
  62.    
  63.    
  64.    
  65.    
  66.    
  67.    
  68.    
  69.    
  70.    
  71.    
  72.    
  73.    
  74.    
  75.    
  76.    
  77.    
  78.    
  79.    
  80.    
  81.    
  82.    
  83.    
  84.    
  85.    
  86.    
  87.    
  88.    
  89.    
  90.                                       Dad
  91.    
  92.                            You helped so very much!
  93.    
  94.    
  95.    
  96.    
  97.    
  98.    
  99.    
  100.    
  101.    
  102.    
  103.    
  104.    
  105.    
  106.    
  107.    
  108.    
  109.    
  110.    
  111.    
  112.    
  113.    
  114.    
  115.    
  116.    
  117.    
  118.    
  119.                                      -ii-    Obs Toolkit 1.5                                               Contents
  120.    
  121.                                Table of Contents
  122.          -------------------------------------------------------------
  123.    
  124.          SHAREWARE...................................................1
  125.            Distribution..............................................1
  126.            Contacting the author.....................................2
  127.    
  128.          REGISTRATION................................................3
  129.            Refund policy.............................................4
  130.            ASP Ombudsman.............................................4
  131.    
  132.          INTRODUCTION................................................5
  133.    
  134.          SYSTEM REQUIREMENTS.........................................8
  135.    
  136.          SYSTEM RECOMMENDATIONS......................................8
  137.            Disk caching software.....................................8
  138.            286 or better.............................................8
  139.            RAM disks.................................................9
  140.            Hard disk drive...........................................9
  141.    
  142.          INSTALLATION...............................................10
  143.            Quick installation.......................................10
  144.            User installation........................................11
  145.            Bad command or file name.................................12
  146.            Installing on a RAM disk.................................14
  147.            Batch files..............................................14
  148.    
  149.          GETTING STARTED............................................16
  150.            WildSpecs................................................17
  151.            SmartPaths...............................................18
  152.            Date & time..............................................19
  153.            Quoting strings..........................................20
  154.            Line editor..............................................20
  155.            ErrorLevels..............................................21
  156.            Options..................................................21
  157.            Reading the usage........................................22
  158.            Press any key............................................22
  159.    
  160.          TOOLS:
  161.            ObsRes, ReRes & DirStack.................................23
  162.            Alias....................................................28
  163.            DirSize..................................................36
  164.            EnvEdit..................................................39
  165.            FileDump.................................................45
  166.            ListFiles................................................51
  167.            Locate...................................................61
  168.            MultiFile................................................64
  169.            ObsCD....................................................74
  170.    
  171.          APPENDICES:
  172.            A: Quick Reference.......................................81
  173.            B: Bug report............................................87
  174.            C: Survey form...........................................88
  175.            D: Registration form.....................................89
  176.    
  177.    
  178.                                      -iii-    Obs Toolkit 1.5                              Copyrights and Trademarks
  179.    
  180.    Copyrights
  181.    ----------
  182.    Alias     Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  183.    DirSize   Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  184.    DirStack  Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  185.    EnvEdit   Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  186.    FileDump  Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  187.    ListFiles Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  188.    Locate    Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  189.    MultiFile Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  190.    ObsCD     Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  191.    ObsRes    Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  192.    ReRes     Copyright (c) 1991 1992, Contrails, Inc., All rights reserved.
  193.    
  194.    
  195.    Trademarks
  196.    ----------
  197.    Obs Toolkit is a trademark of Contrails, Inc.
  198.    
  199.    MS-DOS and Windows are trademarks of Microsoft Corporation.
  200.    
  201.    Borland C++, Turbo Assembler, Turbo Debugger, Turbo Profiler, and Turbo
  202.    Pascal are all trademarks of Borland International Inc.
  203.    
  204.    All Borland products are registered trademarks of Borland International,
  205.    Inc.
  206.    
  207.    DESQview is a trademark of Quarterdeck Office Systems.
  208.    
  209.    PC Magazine is a registered trademark of Ziff Communications Co.
  210.    
  211.    CompuServe Magazine is a registered trademark of CompuServe Incorporated.
  212.    
  213.    PC-Kwik is a trademark of Multisoft corporation.
  214.    
  215.    PC-Tools is a trademark of Central Point Software Inc.
  216.    
  217.    Spontaneous Assembly is a trademark of Acclaim Technologies Inc.
  218.    
  219.    UNIX is a trademark of AT&T Bell Laboratories.
  220.    
  221.    Macintosh is a trademark of Apple Computer.
  222.    
  223.    The ZIP file was produced by PKZIP 1.1. PKZIP is a registered trademark
  224.    of PKWARE Inc. The ZIP file format is public domain.
  225.    
  226.    The self extracting file was produced by LHARC 2.13. LHARC is a
  227.    copyrighted product; its copyright is owned by Haruyasu Yoshizaki.
  228.    
  229.    All other brand and product names are trademarks or registered trademarks
  230.    of their respective holders.
  231.    
  232.    
  233.    
  234.    
  235.    
  236.    
  237.                                      -iv-    Obs Toolkit 1.5                              Copyrights and Trademarks
  238.    
  239.    Tools used while developing Obs Toolkit
  240.    ---------------------------------------
  241.    This Toolkit was produced using the Borland C++ compiler, and Turbo
  242.    Assembler. The product was Debugged, Profiled and optimized using
  243.    Borland's Turbo Debugger, and Turbo Profiler. Basetwo developments
  244.    Spontaneous Assembly provided the routines to access the environment
  245.    blocks.
  246.    
  247.    The Shareware documentation was prepared using the MicroStar editor
  248.    supplied in Borland's Turbo Pascal Editor Toolbox.
  249.    
  250.    Mark and Release were used extensively during testing of ObsRes and
  251.    ReRes. Mark and Release are available on CompuServe in a file called
  252.    TSRCOM.ARC. TSRCOM was produced by TurboPower Software.
  253.    
  254.    Apologies
  255.    ---------
  256.    We apologize for any spelling or grammatical errors that may be in this
  257.    document. The real document is a definite cut above. The word processor
  258.    used to prepare the formal document is much better than the text editor
  259.    used to prepare this document. Even the inconsistencies of format and
  260.    style have been addressed.
  261.    
  262.    This document has been prepared for the lowest common denominator of
  263.    printer. The only thing that this document requires is a page size of at
  264.    least 80 columns by 60 lines and the ability to process a Form-Feed.
  265.    
  266.    The printed manual (which you receive for registering) is not a straight
  267.    copy of this document. The printed manual makes extensive use of fonts &
  268.    bolding to draw special attention to key topics. We put the same quality
  269.    into the printed manual as we did into the Toolkit.
  270.    
  271.    
  272.    
  273.    
  274.    
  275.    
  276.    
  277.    
  278.    
  279.    
  280.    
  281.    
  282.    
  283.    
  284.    
  285.    
  286.    
  287.    
  288.    
  289.    
  290.    
  291.    
  292.    
  293.    
  294.    
  295.    
  296.                                       -v-    Obs Toolkit 1.5                                 Disclaimer of warranty
  297.    
  298.    
  299.    
  300.    
  301.    
  302.    
  303.    
  304.                             DISCLAIMER OF WARRANTY
  305.    
  306.    
  307.           THIS  SOFTWARE  AND  MANUAL  ARE  SOLD  "AS IS" AND WITHOUT
  308.    
  309.           WARRANTIES    INCLUDING    ANY    IMPLIED    WARRANTY    OF
  310.    
  311.           MERCHANTABILITY  OR  IMPLIED  WARRANTY  OF  FITNESS  FOR  A
  312.    
  313.           PARTICULAR  PURPOSE.  NO  WARRANTY  AS  TO  PERFORMANCE  OR
  314.    
  315.           MERCHANTABILITY  OR WARRANTY  OF FITNESS  FOR A  PARTICULAR
  316.    
  317.           PURPOSE IS OFFERED.
  318.    
  319.    
  320.    
  321.           GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE
  322.    
  323.           THOROUGHLY TESTED WITH NON-CRITICAL  DATA BEFORE RELYING ON
  324.    
  325.           IT.   BECAUSE  OF   THE  VARIOUS   HARDWARE  AND   SOFTWARE
  326.    
  327.           ENVIRONMENTS  INTO WHICH  THIS PROGRAM  MAY BE  PLACED, THE
  328.    
  329.           USER MUST ASSUME THE ENTIRE  RISK OF USING THE PROGRAM. THE
  330.    
  331.           AUTHOR  MAY NOT  BE HELD   LIABLE FOR  ANY USE,  MISUSE, OR
  332.    
  333.           INABILITY TO USE THIS SOFTWARE. ANY LIABILITY OF THE SELLER
  334.    
  335.           WILL  BE  LIMITED  EXCLUSIVELY  TO  PRODUCT  REPLACEMENT OR
  336.    
  337.           REFUND OF PURCHASE PRICE.
  338.    
  339.    
  340.           If the software doesn't work on your platform, then let us
  341.           know and we will attempt to fix it. Use the attached bug
  342.           form in appendix B.
  343.    
  344.    
  345.    
  346.    
  347.    
  348.    
  349.    
  350.    
  351.    
  352.    
  353.    
  354.    
  355.                                      -vi-    Obs Toolkit 1.5                                              Shareware
  356.    
  357.                                    Shareware
  358.                                    ---------
  359.    
  360.    Obs Toolkit is NOT public domain software or FreeWare. Obs Toolkit is
  361.    protected by copyright and all such rights are owned by Contrails, Inc.
  362.    
  363.    Shareware is a software distribution method. By evaluating software
  364.    distributed as Shareware, you should find software that meets your needs
  365.    yet doesn't clean out your wallet. Shareware distribution permits you to
  366.    try the software before you buy; that way you know exactly what you are
  367.    getting. The cost of Shareware is lower because you do the marketing for
  368.    the developer.
  369.    
  370.    If you like the software then please share it with a few friends. They
  371.    will be happy, we will be happy, and you will too. Everybody wins. If you
  372.    continue to use the Shareware, after the evaluation period has elapsed,
  373.    you are required to register. If you do not continue to use the software,
  374.    then don't register. Nobody ever has to pay for software that they won't
  375.    use if they look into Shareware first.
  376.    
  377.    Obs Toolkit is distributed through Shareware marketing so that you may
  378.    evaluate the Toolkit before your purchase. If you decide that Obs Toolkit
  379.    is useful, and you want to continue using it, then you must register with
  380.    Contrails, Inc. We repeat, so that it is perfectly clear; if you use it,
  381.    you must register it.
  382.    
  383.    When your registration is received a registered copy of Obs Toolkit, that
  384.    eliminates the random Ob-noxious messages and provides you a printed
  385.    manual will be promptly mailed.
  386.    
  387.    The printed manual, Ob-Noxious message elimination, technical support,
  388.    peace of mind, and updates at a reduced cost will be the gifts you
  389.    receive for registering this Toolkit.
  390.    
  391.    Soon you will be wielding Obs Toolkit like a true master. (Don't forget
  392.    to register.)
  393.    
  394.    Distribution
  395.    ------------
  396.    Distribution of Obs Toolkit is limited to the Shareware version.
  397.    
  398.    You are encouraged to distribute copies of Obs Toolkit (Shareware) to the
  399.    open public so long as all unmodified files, and this unmodified document
  400.    are distributed also. It is recommended that the file OBSKIT.ZIP or
  401.    OBSKIT.EXE be distributed. Obs Toolkit is not to be distributed without
  402.    the documentation and registration form.
  403.    
  404.    A fee may be charged for the distribution of Obs Toolkit (Shareware), but
  405.    the fee must be less than $7. When distributing this Toolkit you should
  406.    represent the product as being distributed through Shareware marketing.
  407.    Registration with the author is required if any of the software is still
  408.    being used after the evaluation period. The product can not be presented
  409.    as FREE software.
  410.    
  411.    
  412.    
  413.    
  414.                                       -1-    Obs Toolkit 1.5                                              Shareware
  415.    
  416.    Distribution of registered versions shall be strictly prohibited.
  417.    
  418.    Contacting the Author
  419.    ---------------------
  420.    The author can be reached via CompuServe:
  421.      o CIS 71121,2426         (CompuServe Information Service)
  422.    
  423.    Contrails can be reached via mail, phone, or Fax:
  424.      Contrails, Inc.          (805) 733-2808 (Voice)
  425.      P.O. Box 2759            (805) 733-3066 (Fax)
  426.      Lompoc, CA 93438-2759
  427.    
  428.    Random Ob-noxious messages
  429.    --------------------------
  430.    The random Ob-noxious messages are a feature to remind you that you are
  431.    evaluating a product distributed as Shareware.
  432.    
  433.    These messages will go away when you receive your registered version of
  434.    Obs Toolkit.
  435.    
  436.    The message appearance is completely random, however the frequency is
  437.    just high enough to be a solid reminder without deterring from the
  438.    product quality. The goal being, that the more benefit the Toolkit is to
  439.    you, the more often that you will see the messages.
  440.    
  441.    The random Ob-noxious messages
  442.      o are designed to let you see the Tool in operation as it would appear
  443.        if it were registered (this is when the message does not appear).
  444.    
  445.      o provide you with no loss in Toolkit capability. You are evaluating a
  446.        complete Toolkit. No corners have been cut or capability disabled.
  447.    
  448.      o are only a minor inconvenience during Toolkit evaluation.
  449.    
  450.      o are going to be a constant reminder that you should register.
  451.    
  452.    Please don't put up with the messages, they only get in your way.
  453.    
  454.    User Obligations
  455.    ----------------
  456.    You may evaluate this product. You may not modify this software or
  457.    documentation in any way. You are encouraged to share this software with
  458.    others.
  459.    
  460.    This Toolkit took over a year to produce. One man working very hard for a
  461.    dream to (hopefully) come true. Shareware is not free. The author worked
  462.    early mornings, late evenings, and most weekends to produce software that
  463.    you can benefit from. You can be part of the dream come true! If you
  464.    continue to use this software, then you must register. It is not an
  465.    option, it's an obligation. If you do not register (but continue to use
  466.    the Toolkit anyway), then you are telling the author and authors family
  467.    (wife and kids) that the money and time spent were not worth it. If you
  468.    use it, register it! Your registration is their reward. End of plea!
  469.    
  470.    
  471.    
  472.    
  473.                                       -2-    Obs Toolkit 1.5                                           Registration
  474.    
  475.                                  Registration
  476.                                  ------------
  477.    
  478.    To register this copy of Obs Toolkit, fill out the order form and mail
  479.    with payment to the address specified.
  480.    
  481.    A registration form is included as Appendix D.
  482.    
  483.    Upon receipt of your order, a registered version of Obs Toolkit will be
  484.    promptly mailed to you. You will then be entitled to technical support,
  485.    and updates at a reduced cost.
  486.    
  487.    Technical support will always available. If after one (1) hour of phone
  488.    support you are asking basic questions (answers readily available in the
  489.    documentation), then the "free" technical support will be exhausted and
  490.    will become an additional cost item. Good questions are always free. Most
  491.    questions are good questions.
  492.    
  493.    Individual Use
  494.    --------------
  495.    Registration is $39.00 plus shipping and handling. Registration includes
  496.    a registered version and a printed manual.
  497.    
  498.    Upgrades from version 1.0 are available for $11.00 plus shipping and
  499.    handling. Upgrade registration includes a registered version and a
  500.    printed manual.
  501.    
  502.    Corporations / Institutions
  503.    ---------------------------
  504.    A license to use Obs Toolkit is required in corporations and
  505.    institutions. The license will allow duplication of the Toolkit at a
  506.    single site for the number of copies purchased. The cost of the license
  507.    is based on the number of machines on which the Toolkit will be running.
  508.    
  509.    The schedule of fees is as follows:
  510.    
  511.                    Number of copies           Price per copy
  512.                    ----------------           --------------
  513.                              1                   $39.00
  514.                        2 -   9                    28.00
  515.                       10 -  24                    24.00
  516.                       25 -  49                    21.00
  517.                       50 - 100                    19.00
  518.    
  519.    All payments must be in U.S. dollars.
  520.    
  521.    Regardless of the quantity ordered, only one (1) manual, and one disk
  522.    containing the registered copy of the Toolkit will be mailed. Upon
  523.    receipt, you will be authorized to make as many copies of the Toolkit as
  524.    you are licensed. The printed manual may not be reproduced. Additional
  525.    printed manuals are $6.00 each.
  526.    
  527.    Site licenses are negotiable.
  528.    
  529.    
  530.    
  531.    
  532.                                       -3-    Obs Toolkit 1.5                                           Registration
  533.    
  534.                                  Refund Policy
  535.                                  -------------
  536.    
  537.    Each registration comes with a 30 day, no questions asked, money back
  538.    guarantee. In the event of a system incompatibility, the guarantee is
  539.    extended to a full 90 days.
  540.    
  541.    Upon receipt of properly returned merchandise, Contrails will refund the
  542.    full purchase price of the software less shipping and handling. Contrails
  543.    will not accept items returned with insufficient postage or COD charges.
  544.    
  545.    Before you return the Toolkit you must contact Contrails, Inc. for a
  546.    Return Authorization number. Returns will not be accepted without one.
  547.    
  548.    You must return the registered disk and manuals in good condition.
  549.    
  550.    
  551.                                  ASP Ombudsman
  552.                                  -------------
  553.    
  554.    This program is produced by a member of the Association of Shareware
  555.    Professionals (ASP). ASP wants to make sure that the shareware principle
  556.    works for you. If you are unable to resolve a shareware-related problem
  557.    with an ASP member by contacting the member directly, ASP may be able to
  558.    help. The ASP Ombudsman can help you resolve a dispute or problem with an
  559.    ASP member, but does not provide technical support for members' products.
  560.    Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-
  561.    9427 or send a Compuserve message via CompuServe Mail to ASP Ombudsman
  562.    70007,3536"
  563.    
  564.    
  565.    
  566.    
  567.    
  568.    
  569.    
  570.    
  571.    
  572.    
  573.    
  574.    
  575.    
  576.    
  577.    
  578.    
  579.    
  580.    
  581.    
  582.    
  583.    
  584.    
  585.    
  586.    
  587.    
  588.    
  589.    
  590.    
  591.                                       -4-    Obs Toolkit 1.5                                           Introduction
  592.    
  593.                                  Introduction
  594.                                  ------------
  595.    
  596.    Obs (Aubz not Oh Beez) Toolkit is a DOS command line supplement. Many of
  597.    the tools that DOS provides fall short of the capability that is needed
  598.    during a normal file management session. File management is an ongoing
  599.    activity, and as such, the better the tools the more organized you are,
  600.    and the less time you spend managing files.
  601.    
  602.    Obs Toolkit can be used to supplant many of the DOS internal commands
  603.    with enhanced command equivalents. Obs Toolkit can be customized to
  604.    provide commands such as:
  605.    
  606.       o ALIAS  (define your own commands)
  607.       o ATTRIB (set and/or clear any DOS attributes)
  608.       o CD     (fuzzy matching, across disks, push, pop, up)
  609.       o COPY   (add, update, replace, add & update, archive only)
  610.       o DELETE (files, directories with contents)
  611.       o DIR    (any sort, duplicates, old files, identical contents)
  612.       o LOCATE (commands, files, multiple disks)
  613.       o MOVE   (between directories, across disks, whole directories)
  614.       o RENAME (files, directories)
  615.       o SET    (any environment, editor, long variables, batchable)
  616.       o TOUCH  (set file date and time to any valid timestamp)
  617.       o TREE   (with directory sizes, creation dates)
  618.       o TYPE   (ASCII only, HEX dump, strings, count, multiple files)
  619.    
  620.    Obs Tools come with:
  621.    
  622.       o Enhanced wildcard capabilities
  623.         o Multiple '*'s
  624.       o Overwrite protection
  625.         o Yes to cautions
  626.         o Force operations
  627.       o Coarse and fine selection criteria
  628.         o Time and date
  629.         o File size
  630.         o File attributes
  631.         o User prompt
  632.       o Activity monitoring
  633.         o Test effects before operation
  634.       o Command generation
  635.         o Customize command line
  636.         o Auto build batch files
  637.       o SmartPaths
  638.         o Pseudo drives
  639.       o Errorlevels
  640.       o and a whole lot more
  641.    
  642.    Obs Toolkit contains virtually hundreds of capable commands. Some authors
  643.    would distribute the programs individually for about the same price as we
  644.    are offering the integrated Toolkit.
  645.    
  646.    
  647.    
  648.    
  649.    
  650.                                       -5-    Obs Toolkit 1.5                                           Introduction
  651.    
  652.    Some of the capabilities provided in this package are available
  653.    elsewhere, but none come with quite the same flavor. Many of the other
  654.    capabilities are fresh ideas and do not exist anywhere.
  655.    
  656.    With this package installed on your computer most other users won't even
  657.    notice that anything has changed. Their work will get done quicker,
  658.    easier, and faster, but they won't have to learn a thing to start using
  659.    the Toolkit.
  660.    
  661.    Using Obs Toolkit in batch files will provide you with new found control
  662.    capabilities. You will be able to modify the users environment (disk,
  663.    directory, environment variables, aliases, etc..)., launch an application
  664.    (if applicable), and then restore the complete environment to what it was
  665.    before the batch file executed; the user will be so pleased!
  666.    
  667.    
  668.    Flagships
  669.    ---------
  670.    Since this is a Toolkit of many diverse, yet integrated tools, you might
  671.    ask what the flagship of the Toolkit may be. Tough question. It would be
  672.    ObsCD; the tool that can get you to any directory with ease; or is it
  673.    EnvEdit, the tool that lets you edit your PATH statement.
  674.    
  675.    Are these better than ListFiles? ListFiles can present you orderly lists
  676.    of files, sorted to your specifications. No, it must be MultiFile! Once
  677.    you have the list of files, and you are located in the correct directory,
  678.    MultiFile will take the same command line given to ListFiles and
  679.    manipulate them. So there we have it.
  680.    
  681.    No WAIT! ObsRes made it all possible by providing command line
  682.    substitution, and holding the DirStack; what are we driving at here?
  683.    
  684.    Obs Toolkit is an integrated collection of tools. There is NO flagship.
  685.    Each tool has a purpose and works with the others to give you a robust
  686.    environment from which to compute. The flagship is the Toolkit!
  687.    
  688.    Under the Hood
  689.    --------------
  690.    Obs Toolkit is very well behaved. Its use of undocumented DOS has been
  691.    kept to a minimum and it never performs disk writes directly, it always
  692.    uses DOS.
  693.    
  694.    The undocumented features of DOS used by Obs Toolkit are nearly standard
  695.    today and should present no problems whatsoever. The undocumented
  696.    features used are:
  697.    
  698.      o EnvEdit   - technique for locating environment blocks
  699.      o DirSize   - calculation for disk space used by a sub-directory
  700.      o MultiFile - determination of SUBSTituted / JOINed drives
  701.    
  702.    That's it. This Toolkit should be safe on all platforms, however we do
  703.    recommend giving each tool a thorough run through just to be sure.
  704.    
  705.    
  706.    
  707.    
  708.    
  709.                                       -6-    Obs Toolkit 1.5                                           Introduction
  710.    
  711.    Most DOS utilities can not boast this high level of compatibility. They
  712.    are more concerned with performance than safety and compatibility. The
  713.    performance of Obs Toolkit has been achieved through careful selection of
  714.    the algorithms which minimize redundant and unnecessary operations thus
  715.    saving time.
  716.    
  717.    Some performance areas of the Toolkit could be significantly enhanced by
  718.    using additional undocumented DOS features or writing directly to disk.
  719.    But we ask you now, would you like an activity to take a few more
  720.    milli-seconds, or would you like to hunt down the Lost Clusters and
  721.    repair the damaged file?
  722.    
  723.    The best operator on files is DOS. Obs Toolkit uses DOS. Obs Toolkit is
  724.    proud to use DOS!
  725.    
  726.    It's OK to want more
  727.    --------------------
  728.    The reason COMMAND.COM has such primitive commands resident, as opposed
  729.    to a shell that has all commands external, is that back in the olden days
  730.    (circa 1981), the PC was an infantile machine. Sure it was a lot of power
  731.    (compared to a calculator) but it was almost a joke by today's standards.
  732.    
  733.    The designers of DOS's command interpreter were faced with a real
  734.    challenge. With only a floppy drive as standard equipment, were users
  735.    willing to wait for external commands to be found and launched? Would
  736.    users be willing to place the disk back in the drive when the commands
  737.    were needed. The answer was both YES and NO.
  738.    
  739.    Yes they would have to use external commands, because RAM was limited,
  740.    and No they wouldn't because the embedded internal commands did not have
  741.    to be embedded at all. The developers split COMMAND.COM into three
  742.    pieces. Initialization, resident, and transient.
  743.    
  744.    The transient portion contains the internal commands and gets loaded into
  745.    high memory. That way if an application needs the memory, DOS will
  746.    allocate away the transient portion of COMMAND.COM.
  747.    
  748.    When resident COMMAND.COM gets control back (COMMAND.COM is really just a
  749.    shell), it checks if the transient is O.K. If the transient is corrupted
  750.    the resident portion reloads the transient portion back into high memory.
  751.    
  752.    With this technique, DOS provides users with internal commands that have
  753.    a low memory overhead. Unfortunately, as the machines evolved,
  754.    COMMAND.COM remained much the same. This has not been a problem because
  755.    COMMAND.COM is slick. So slick in fact, that many programs are intimately
  756.    involved with its normal operations. Replacing COMMAND.COM is a delicate
  757.    task and you'll never know if you get all the bugs out.
  758.    
  759.    The problem with COMMAND.COM are those primitive internal commands. They
  760.    seem to get you half the way there and then leave you hanging. Sure there
  761.    is third party software. Another interface to learn; shell in and out to
  762.    get a job done, but you are already in DOS, and you probably like using
  763.    DIR for directory and COPY for copy. What can be done?
  764.    
  765.    
  766.    
  767.    
  768.                                       -7-    Obs Toolkit 1.5                                           Introduction
  769.    
  770.    The only real inconvenience is that COMMAND.COM recognizes its internal
  771.    commands before it recognizes anything else. If something were to
  772.    translate the users input to invoke different tools it could effectively
  773.    enhance the DOS command line.
  774.    
  775.    The solution is Obs Toolkit. A set of external commands that can hide the
  776.    internal DOS commands and consistently go that extra mile. By using
  777.    aliased commands, the Toolkit is able to hide the COMMAND.COM internal
  778.    commands with superior Toolkit commands; and with careful planning (and a
  779.    lot of testing we might add), you shouldn't even notice that they're
  780.    there. Some have a little twist but it's more capability, increased
  781.    convenience or a safety cushion. In the case of the safety cushion, you
  782.    can always inhibit it.
  783.    
  784.    
  785.                               System Requirements
  786.                               -------------------
  787.    
  788.      o DOS 3.0 or higher.
  789.      o 256K memory.
  790.    
  791.    
  792.                             System Recommendations
  793.                             ----------------------
  794.    
  795.    Disk caching software
  796.    ---------------------
  797.    Use of Disk caching software such as SMARTDrive, Super-PC Kwik, or
  798.    PC-Cache, just to name a few, will significantly reduce repeated access
  799.    time to your application programs, and reduce wear and tear on your disk
  800.    drive as well.
  801.    
  802.    Disk caching software stores the most recent disk accesses in computer
  803.    memory. That way if the computer asks for the same information in
  804.    relatively short order, the disk caching software can answer the request
  805.    without accessing the disk.
  806.    
  807.    The disk caching software doesn't help the execution of the tools, but it
  808.    will speed your access time to them, and to the data that the tools
  809.    require. The Toolkit provides its own internal caching.
  810.    
  811.    SMARTDrive is available with MS-DOS versions 4.0+ and with Windows 3.0.
  812.    
  813.    Super PC-Kwik Disk Accelerator is available as a stand alone product from
  814.    Multisoft Corporation.
  815.    
  816.    PC-Cache is available with PC-Tools, from Central Point Software Inc.
  817.    
  818.    
  819.    286 or better
  820.    -------------
  821.    If you have a 286 or better processor, then go ahead and supplant the DOS
  822.    internal commands.
  823.    
  824.    
  825.    
  826.    
  827.                                       -8-    Obs Toolkit 1.5                                           Introduction
  828.    
  829.    If you are still on the 8088/8086 class of processors, then using the
  830.    tools in the native mode and using DOS internal commands is probably the
  831.    most efficient way to go. Because some commands like OCD are so
  832.    outstanding you might want to install the Toolkit anyway.
  833.    
  834.    If you don't want to replace the DOS internal commands (a little
  835.    sentimental maybe) then by all means, still use ObsRes, and install an
  836.    Alias dictionary and DirStack. The small amount of memory used is put to
  837.    good use and you can define your own commands.
  838.    
  839.    
  840.    RAM Disks
  841.    ----------
  842.    If you install a RAM disk, then feel free to place the Toolkit on the RAM
  843.    disk. This will (naturally) give you the best performance. It makes sense
  844.    however (if RAM disk space is limited), to place the most frequently used
  845.    commands on the RAM disk, and leave the less used commands on disk. In
  846.    this case you may want to further the definition of the OB alias with OB1
  847.    and OB2, where OB1 is the disk and OB2 is the RAM drive.
  848.    
  849.    For more information on RAM Disks see Installation/Installing on a RAM
  850.    disk.
  851.    
  852.    
  853.    Hard disk drive
  854.    ---------------
  855.    If you don't have a hard disk drive, RAM disk, or a network where the
  856.    tools are easily located, then once again we recommend using the DOS
  857.    internal commands for normal activities, and using the Toolkit in native
  858.    mode as desired.
  859.    
  860.    
  861.    
  862.    
  863.    
  864.    
  865.    
  866.    
  867.    
  868.    
  869.    
  870.    
  871.    
  872.    
  873.    
  874.    
  875.    
  876.    
  877.    
  878.    
  879.    
  880.    
  881.    
  882.    
  883.    
  884.    
  885.    
  886.                                       -9-    Obs Toolkit 1.5                                           Installation
  887.    
  888.                                  Installation
  889.                                  ------------
  890.    
  891.    Supplied files
  892.    --------------
  893.    The documentation supplied with Obs Toolkit is:
  894.    
  895.        o OBSKIT.DOC   - This file
  896.        o REGISTER.DOC - Registration form
  897.        o VENDOR.DOC   - Distribution notes
  898.        o UPDATES.DOC  - Changes since version 1.0
  899.        o UPGRADE.DOC  - Notes for users of version 1.0
  900.        o README.TXT   - Quick intro / Late breaking news
  901.    
  902.    To install Obs Toolkit onto your machine, add the following files to your
  903.    utility directory (these files just need to be visible via DOS's path):
  904.    
  905.        o ALIAS.EXE    - Alias, the alias generator
  906.        o DIRSTACK.COM - Directory Stack without aliases
  907.        o DS.EXE       - DirSize, a tree with sizes
  908.        o EE.EXE       - EnvEdit, a DOS environment editor
  909.        o FD.EXE       - FileDump, the file viewer
  910.        o LF.EXE       - ListFiles, the file lister
  911.        o LOCATE.EXE   - Locate, the executable command and file locator
  912.        o MF.EXE       - MultiFile, the file manipulator
  913.        o OBSRES.COM   - Alias translator, dictionary, and directory stack
  914.        o OCD.EXE      - ObsCD, a super-intelligent Change Directory
  915.        o RERES.COM    - Re-Resident alias dictionary
  916.    
  917.    The following files are provided as examples on how to customize your
  918.    command line interface:
  919.    
  920.        o ALIASES.DOS  - This is an alias definition file that supplants the
  921.                         DOS internal commands with enhanced Toolkit
  922.                         commands. No additional commands are provided.
  923.    
  924.        o ALIASES.REC  - This is an alias definition file filled with
  925.                         recursive aliases. This file contains most of the
  926.                         aliases described in this document, using recursive
  927.                         definitions to optimize performance
  928.    
  929.        o XDOS.CFG     - An alias definition file for use with NDOS and 4DOS.
  930.    
  931.        o PCED.CFG     - An alias definition file for use with PCED.
  932.    
  933.    
  934.    Quick installation
  935.    ------------------
  936.    To install the Toolkit quickly:
  937.    
  938.        1) Change to the directory where the Toolkit files are located.
  939.        2) Type install at the command line.
  940.    
  941.    INSTALL.BAT will create a file called ALIASES.FIL in the Toolkit
  942.    directory, and will MODIFY your AUTOEXEC.BAT (on drive C:) by appending
  943.    the following lines:
  944.    
  945.                                       -10-    Obs Toolkit 1.5                                           Installation
  946.    
  947.    
  948.        [obs_path]OBSRES
  949.        [obs_path]ALIAS /FILE [obs_path]\ALIASES.FIL
  950.    
  951.    In the event that you have a menu program take control of the computer
  952.    from the AUTOEXEC.BAT, then you will have to move the above two lines
  953.    from the bottom of the file.
  954.    
  955.    It is also recommended that you modify your PATH statement to include the
  956.    Toolkit directory. That will enable you to use the Toolkit commands from
  957.    a batch file.
  958.    
  959.    
  960.    User installation
  961.    -----------------
  962.    Then add the following lines near the end of your AUTOEXEC.BAT file:
  963.    
  964.        OBSRES
  965.        ALIAS /FILE [obs_path]\ALIASES.REC
  966.    
  967.    To build the OCD Hot Directory (HotDir) file, just type
  968.    
  969.        C>OCD /READ
  970.    
  971.    Note:
  972.        The ALIASES.REC file contains most of the aliases suggested in this
  973.        document. This files can be executed either as a DOS command by
  974.        renaming it to ALIASES.BAT and entering ALIASES at the command prompt, or
  975.        by being processed by the ALIAS utility by typing:
  976.    
  977.           ALIAS /FILE [path]\ALIASES.REC
  978.    
  979.        Processing the aliases via /FILE is quicker than DOS batch files.
  980.    
  981.        The ObsRes DOS aliases are described in the file ALIASES.DOS. The
  982.        ObsRes recursive aliases are described in the file ALIASES.REC.
  983.    
  984.        Feel free to customize the installation as you see fit.
  985.    
  986.        Recursive aliases are swapped again and again until no more swaps are
  987.        possible or the recursion limit is exceeded.
  988.    
  989.    Define the OB alias
  990.    -------------------
  991.      The OB alias is used to specify the directory that the tools are
  992.      located in. The OB alias is not limited to just Obs Toolkit; its
  993.      concept can (should?) be extended to all tools.
  994.    
  995.      OB is defined so that DOS knows where to locate a tool. It resolves to
  996.      the exact pathname so that DOS does not have to spend time searching
  997.      other directories in the path.
  998.    
  999.    
  1000.    
  1001.    
  1002.    
  1003.    
  1004.                                       -11-    Obs Toolkit 1.5                                           Installation
  1005.    
  1006.      OBs purpose is strictly performance optimization. OB is not required
  1007.      and can be "null defined." The recursive alias definition file supplied
  1008.      with Obs Toolkit currently has it "null defined." To draft OB into
  1009.      service you must define it.
  1010.    
  1011.      Two ways to define OB
  1012.      ---------------------
  1013.    
  1014.        1) Use an editor to edit the Alias definition file
  1015.    
  1016.           This technique has the advantage of retaining the comments in the
  1017.           ALIASES.REC file.
  1018.    
  1019.           Open the alias definition file in an editor and change the
  1020.             ALIAS /NULL OB
  1021.           to
  1022.             ALIAS /NOSPACE OB drive:\path\
  1023.    
  1024.        2) Define it with ALIAS, and redirect the file output
  1025.    
  1026.           These techniques require that ObsRes be installed. It is
  1027.           recommended that the aliases be previously loaded.
  1028.    
  1029.           If you are located in the Toolkit directory, you can type
  1030.             ALIAS /MAKE OB
  1031.           otherwise define the OB alias by typing:
  1032.             ALIAS /NOSPACE OB drive:\path\
  1033.    
  1034.           To save the definition in the alias definition file type
  1035.             ALIAS > drive:\path\filename.ext
  1036.             ==>> The redirected output will lose any comment and nesting
  1037.                  information in the alias definition file.
  1038.    
  1039.        Note:
  1040.          Regardless of the technique used be sure to define OB using the
  1041.          "/NOSPACE" qualifier and include the trailing "\".
  1042.    
  1043.          If you choose to use the /MAKE option, be sure that you are located
  1044.          in the Toolkit directory.
  1045.    
  1046.    Bad command or file name
  1047.    ------------------------
  1048.      If you are configuring a system with recursive aliases, and the command
  1049.      line becomes unresponsive "doesn't do anything" or degenerates to "Bad
  1050.      command or file name", then the commands are being swapped incorrectly.
  1051.      Use the following procedure to identify and correct the error:
  1052.    
  1053.        1) Turn the translation echo on by typing .ECHO at the command line.
  1054.              C>.ECHO
  1055.    
  1056.        2) Type a simple aliased command (e.g., DIR)
  1057.              C>DIR
  1058.    
  1059.        3) Examine the translation
  1060.    
  1061.           Use 3a if nothing happens when a command is issued at the command
  1062.    
  1063.                                       -12-    Obs Toolkit 1.5                                           Installation
  1064.    
  1065.           line or the machine changes drives.
  1066.    
  1067.           Use 3b, 3c, 3d, or 3e if you receive "Bad command or file name"
  1068.           when using the aliased commands.
  1069.    
  1070.           3a) The command looks like "C:\path\ LF.EXE"
  1071.               The culprit is the space between the path and the tool name.
  1072.               In this case you need to add the /NOSPACE qualifier to the OB
  1073.               alias definition (place this option before the OB name).
  1074.    
  1075.           3b) The command looks like "C:\badpath\LF.EXE"
  1076.               The culprit in this case is that the tools are not located in
  1077.               the specified directory. In this case, you need to correct the
  1078.               definition for the OB alias definition.
  1079.    
  1080.           3c) The command looks like "C:\pathLF.EXE"
  1081.               The culprit in this case is that the trailing "\" was omitted
  1082.               in the alias definition. In this case, you need to correct the
  1083.               definition for the OB alias definition.
  1084.    
  1085.           3d) The command looks line "OB LF.EXE"
  1086.               The culprit in this case is 3E or that the OB alias is not
  1087.               defined. In the latter case you need to define the OB alias
  1088.               definition to specify the directory that the Toolkit is
  1089.               located, or define it to be /NULL.
  1090.    
  1091.           3e) The command looks line "OB LF.EXE"
  1092.               The culprit in this case is 3d or that recursive aliases are
  1093.               not selected. In the latter case you need to enable recursive
  1094.               aliases (ALIAS /RECURSE).
  1095.    
  1096.        4) Turn the translator off by typing .OFF at the command line.
  1097.              C>.OFF
  1098.    
  1099.        5) Change to the directory that the Toolkit is located in.
  1100.              C>CD \path
  1101.           Note: This is necessary if the Toolkit is not located in the
  1102.           current DOS path.
  1103.    
  1104.        6) Use the ALIAS /EDIT to correct the error.
  1105.              C>ALIAS /EDIT OB
  1106.    
  1107.        7) Turn the translator back on by typing .ON at the command line.
  1108.              C>.ON
  1109.    
  1110.        8) Turn the translation echo off by typing .NOECHO at the command
  1111.           line.
  1112.              C>.NOECHO
  1113.    
  1114.        9) Save your changes.
  1115.    
  1116.    
  1117.    
  1118.    
  1119.    
  1120.    
  1121.    
  1122.                                       -13-    Obs Toolkit 1.5                                           Installation
  1123.    
  1124.    Installing on a RAM disk
  1125.    ------------------------
  1126.      Putting Obs Toolkit on a RAM disk can reduce access time to the tools.
  1127.      There are two primary ways to install the Toolkit.
  1128.    
  1129.      Full installation
  1130.      -----------------
  1131.         A full installation is to copy all the tools to the RAM disk. To
  1132.         decrease access time even further use recursive aliases, and set the
  1133.         OB alias to point directly to the RAM disk.
  1134.    
  1135.         This technique will give you the best overall performance (time
  1136.         wise) but requires RAM to do so.
  1137.    
  1138.      Partial installation
  1139.      --------------------
  1140.        The partial installation is probably your best bet. Place your most
  1141.        frequently accessed commands on the RAM disk, and you are home free.
  1142.    
  1143.        To continue receiving the benefit of the Toolkit's use of recursive
  1144.        aliases, it would be best to define two OB aliases. One to point to
  1145.        the RAM disk and the other to point to the hard disk.
  1146.    
  1147.        Say you wanted to put LF.EXE, MF.EXE, and OCD.EXE on your RAM disk
  1148.        (G:), and leave all the others in your C:\UTIL directory. Using
  1149.        recursive aliases you could set up an alias definition file that
  1150.        looks similar to the following:
  1151.    
  1152.        REM This example assumes recursive aliases
  1153.        ALIAS /RECURSE
  1154.    
  1155.        REM these commands set up the directory pointers
  1156.        ALIAS /NOSPACE OB1 C:\UTIL\
  1157.        ALIAS /NOSPACE OB2 G:\
  1158.    
  1159.        REM these commands point to the RAM disk
  1160.        ALIAS          LF  OB2 LF.EXE
  1161.        ALIAS          MF  OB2 MF.EXE
  1162.        ALIAS          OCD OB2 OCD.EXE
  1163.    
  1164.        REM these commands point to the hard disk
  1165.        ALIAS          FD  OB1 FD.EXE
  1166.        ALIAS          DS  OB1 DS.EXE
  1167.        ...etc...
  1168.    
  1169.        If, later, you remove the files from the RAM disk, you can simply
  1170.        redefine OB2 to OB1 to retain instant access to Toolkit commands.
  1171.    
  1172.    Batch files
  1173.    -----------
  1174.      Using Obs Toolkit within batch files is straightforward; in fact it's
  1175.      downright convenient since it uses standard ErrorLevels for everything.
  1176.    
  1177.      You must have the Toolkit directory located in your PATH unless you use
  1178.      fully qualified filenames.
  1179.    
  1180.    
  1181.                                       -14-    Obs Toolkit 1.5                                           Installation
  1182.    
  1183.      For a description of the ErrorLevels see Getting Started/ErrorLevels.
  1184.    
  1185.      You cannot use aliased commands from within a batch file, you must type
  1186.      the proper tool name, and supply all of its options.
  1187.    
  1188.      Note 1:
  1189.        LOCATE clearly shows the advantages of fully qualified filenames at
  1190.        the command line (e.g., C:\UTIL\OCD.EXE). This is true in batch files
  1191.        also. To get maximum batch file performance, use fully qualified
  1192.        filenames in your batch files also. This is true for all batch file
  1193.        external commands, not just those in Obs Toolkit.
  1194.    
  1195.      Note 2:
  1196.        To conserve precious system memory and obtain the fastest boot
  1197.        possible, install ObsRes and all your other memory resident programs
  1198.        before establishing your environment (e.g., path, prompt, etc...).
  1199.        This yields the smallest environment block possible for the TSR, but
  1200.        means that you must use a fully qualified filename to launch all
  1201.        programs (the PATH is not set). Be sure to set the environment
  1202.        variables the TSR requires before launching the TSR.
  1203.    
  1204.      Trick:
  1205.        You can now (safely) use the environment in your batch files. As an
  1206.        example consider launching a TSR. Many TSRs today still do not
  1207.        release there environment blocks. Using EnvEdit you can save the
  1208.        current environment block to a file (EE /SAVE filename.exe), clear it
  1209.        out of everything but the required entries (EE /CLEAR), launch the
  1210.        TSR, and then restore the environment from the file (EE /FILE
  1211.        filename.ext).
  1212.    
  1213.        Many other variations of this technique are available. If you study
  1214.        the Toolkit's INSTALL.BAT you will see an example use of EnvEdit to
  1215.        preserve your environment before maniplulating it. The INSTALL.BAT
  1216.        returns everything to normal before exiting.
  1217.    
  1218.    
  1219.    
  1220.    
  1221.    
  1222.    
  1223.    
  1224.    
  1225.    
  1226.    
  1227.    
  1228.    
  1229.    
  1230.    
  1231.    
  1232.    
  1233.    
  1234.    
  1235.    
  1236.    
  1237.    
  1238.    
  1239.    
  1240.                                       -15-    Obs Toolkit 1.5                                        Getting Started
  1241.    
  1242.                                 Getting Started
  1243.                                 ---------------
  1244.    
  1245.    Using Obs Toolkit is easy. You can install it now, start working with it,
  1246.    and then learn more as you go. In a sense you could consider Obs Toolkit
  1247.    to be a DOS shell, but in reality, it is just a collection of tools
  1248.    cooperating to get your work done.
  1249.    
  1250.    Obs Toolkit can be used in two (2) ways. The first way is to place all
  1251.    the programs in your utility directory (which is in your path), and call
  1252.    them up when you need them. The second way is to place the programs in
  1253.    your utility directory, and use Obs Alias generator to replace the DOS
  1254.    internal commands to invoke Obs tools.
  1255.    
  1256.    The first way requires you to remember all those options. The second way
  1257.    embeds the options in the aliased commands. Since only a minimal amount
  1258.    of memory is used and so much capability gained, go ahead, configure your
  1259.    system using option 2.
  1260.    
  1261.    If you consider the Toolkit's use of options to be intimidating, then
  1262.    think about out what you want to do; invoke the help screen for the
  1263.    utility (/?); create an Alias for the command (ALIAS cmd tool switches),
  1264.    and poof, you have just created a brand new command. When you are all
  1265.    done creating commands (or any time you add / delete commands) just write
  1266.    the Alias dictionary out to disk so that it is there the next time you
  1267.    boot your computer.
  1268.    
  1269.    A quick reference guide is included as Appendix A.
  1270.    
  1271.    Getting started with Obs Toolkit will take a little getting used to. All
  1272.    the power is kind of like driving a high performance street mobile. You
  1273.    already know how to drive, and you have a good idea of what most of the
  1274.    gauges are, but you're wondering what that "do-hickey" does and why they
  1275.    provided that "thing-a-ma-bob." As you drive, you begin to appreciate all
  1276.    the careful planning that went into the fine automobile.
  1277.    
  1278.    We encourage you to take Obs Toolkit out for a drive. Press your foot
  1279.    down, see what it can do. Like a good high performance car, you'll find
  1280.    that it "corners like it's on rails."
  1281.    
  1282.    Enough with the allegory. This Toolkit was written with the user in mind.
  1283.    It tries not to presume what you want to do, but to give you the
  1284.    flexibility to easily accomplish your tasks.
  1285.    
  1286.    Give Obs Toolkit a full evaluation. You'll soon wonder how you got along
  1287.    without it.
  1288.    
  1289.    The following items are general concepts and descriptions of items that
  1290.    will greatly enhance your understanding of the Toolkit.
  1291.    
  1292.    
  1293.    
  1294.    
  1295.    
  1296.    
  1297.    
  1298.    
  1299.                                       -16-    Obs Toolkit 1.5                                        Getting Started
  1300.    
  1301.    WildSpecs
  1302.    ---------
  1303.    WildSpecs are strings that are designed by you to match a select class of
  1304.    filenames. WildSpecs are a superset (in usage) of DOS's wildcards.
  1305.    
  1306.    The Metacharacters are the following:
  1307.    
  1308.      ? - matches any single character
  1309.          (a substitution character is required)
  1310.    
  1311.      * - matches any group of characters
  1312.          (zero or more characters may match)
  1313.    
  1314.    Using Obs WildSpecs permits semi-sophisticated matches, such as
  1315.      *ob.*  - any file who's filename ends with "OB", with any extension
  1316.               Example:
  1317.                 The following filenames would match
  1318.                    keepOB.doc
  1319.                    OB.
  1320.                 The following filenames would NOT match
  1321.                    obtest.doc
  1322.                    xxxobx.ob
  1323.    
  1324.      *ob*   - any file who's filename contains "OB" anywhere in the name
  1325.               Example:
  1326.                 The following filenames would match
  1327.                    OBbi.doc
  1328.                    glOBe.lst
  1329.                    OB.
  1330.                 The following filename would NOT match
  1331.                    Oxb.ob
  1332.    
  1333.      *o*b*  - any file who's filename contains "O" followed by "B"
  1334.               Example:
  1335.                 The following filenames would match
  1336.                    keepOB.doc
  1337.                    xOxxBx.any
  1338.                 The following filename would NOT match
  1339.                    bo.
  1340.    
  1341.      *o?b*  - any file who's filename contains '"O" character "B"'
  1342.               Example:
  1343.                 The following filenames would match
  1344.                    OxB.fil
  1345.                    xxOyBx.fil
  1346.                 The following filenames would NOT match
  1347.                    ob.
  1348.                    oxxb.
  1349.    
  1350.      WildSpecs are limited to DOS's 8.3 file notation. All characters after
  1351.      the eighth (in the filename) and third (for the extension) are ignored.
  1352.    
  1353.    
  1354.    
  1355.    
  1356.    
  1357.    
  1358.                                       -17-    Obs Toolkit 1.5                                        Getting Started
  1359.    
  1360.    SmartPaths
  1361.    -----------
  1362.      The DirStack keeps track of where you've been. These places, as long as
  1363.      they are still on the stack, can be referenced by SmartPaths 1: - 9:.
  1364.      SmartPaths in a sense, act just like new drives. You can add additional
  1365.      directory specifiers to a SmartPath, but you may not address via its
  1366.      root.
  1367.    
  1368.      Note: ObsRes or DirStack must be installed for SmartPath operation.
  1369.    
  1370.      To view the directories on the DirStack type:
  1371.        C>OCD /LIST
  1372.    
  1373.        It will make a report like the following example:
  1374.          1: C:\DOS                      **  Top of stack   SmartPath 1: **
  1375.          2: D:\TURBO\TC\CPROGS\OBSKIT   **                 SmartPath 2: **
  1376.          3: E:\BATCH                    **                 SmartPath 3: **
  1377.          4: F:\UTIL                     ** Bottom of stack SmartPath 4: **
  1378.    
  1379.      Using the example DirStack above:
  1380.        C>LF 1:
  1381.           Provides a directory of C:\DOS.
  1382.    
  1383.        C>LF 2:..
  1384.           Provides a directory of D:\TURBO\TC\CPROGS.
  1385.    
  1386.        C>MF /C 2:MF.EXE 4:
  1387.           Copies file D:\TURBO\TC\CPROGS\OBSKIT\MF.EXE to F:\UTIL\MF.EXE.
  1388.    
  1389.      Note:
  1390.        You cannot reference the root of a SmartPath, hence 1:\ is considered
  1391.        an error.
  1392.    
  1393.      The real time saver of this feature is when you want to address another
  1394.      directory on the same drive. DOS will not permit this without
  1395.      SUBSTituting in a new disk, or typing the complete path name.
  1396.    
  1397.      Using the example DirStack above, and assuming that you are currently
  1398.      located in D:\COMM\PROC\UPLOADS, you can easily copy files from the
  1399.      D:\TURBO\TC\CPROGS\OBSKIT without typing the path. Simply typing:
  1400.    
  1401.        D:\COMM\PROC\UPLOADS>MF /C 2:obskit.zip
  1402.    
  1403.      will copy the file D:\TURBO\TC\CPROGS\OBSKIT\OBSKIT.ZIP
  1404.             to the file D:\COMM\PROC\UPLOADS\OBSKIT.ZIP
  1405.    
  1406.      TIP:
  1407.        Define a LIST command to report the SmartPaths on the stack.
  1408.          C>ALIAS list OCD /LIST
  1409.    
  1410.    
  1411.    
  1412.    
  1413.    
  1414.    
  1415.    
  1416.    
  1417.                                       -18-    Obs Toolkit 1.5                                        Getting Started
  1418.    
  1419.    Date & Time
  1420.    -----------
  1421.    
  1422.       date = mm-dd-yy  - the full date must be specified
  1423.       date = -days     - that many days in the past
  1424.    
  1425.            date = -0   - represents today
  1426.            date = -1   - represents yesterday
  1427.              .
  1428.              .
  1429.              .
  1430.            date = -365 - is usually an entire years worth
  1431.    
  1432.    
  1433.       time = hh:mm:ss  - the minutes & seconds are optional
  1434.       time = .         - this translates to the current time
  1435.    
  1436.    
  1437.       Examples (assume the current date and time is "12-25-90 06:00:00")
  1438.    
  1439.          "7-4-90 21:00:00"
  1440.             Independence day, 1990, at 9pm.
  1441.    
  1442.          "10-31-90"
  1443.             Halloween, 1990 - time is not specified and not used.
  1444.    
  1445.          "00:00:00"
  1446.             (today - defaulted) at Midnight.
  1447.    
  1448.          "0"
  1449.             (today - defaulted) "00:00:00" - minutes, seconds default to 0.
  1450.    
  1451.          "12:30"
  1452.             (today - defaulted) "12:30:00" - seconds default to 0.
  1453.    
  1454.          "."
  1455.             (today - defaulted) now "06:00:00".
  1456.    
  1457.          "-0"
  1458.             (today - zero days ago) - time is not specified and not used.
  1459.    
  1460.          "-1"
  1461.             (yesterday) "12-24-90" - time is not specified and not used.
  1462.    
  1463.          "-1 ."
  1464.             (yesterday at this time) "12-24-90 06:00:00" (24 hours ago).
  1465.    
  1466.          "-3 ."
  1467.             (72 hours ago).
  1468.    
  1469.    
  1470.    
  1471.    
  1472.    
  1473.    
  1474.    
  1475.    
  1476.                                       -19-    Obs Toolkit 1.5                                        Getting Started
  1477.    
  1478.    Quoting strings
  1479.    ---------------
  1480.      Occasionally you may want to provide multiple words as a single
  1481.      parameter. To do this, simply quote the string. All the data between a
  1482.      pair of double quotes will be treated as a single word.
  1483.    
  1484.         (e.g., "This is a Quoted string")
  1485.    
  1486.      When using quotes, remember one thing. Don't forget to close the
  1487.      quotes.
  1488.    
  1489.      To insert a quote into a quoted string, prepend each embedded quote
  1490.      with a single backslash. For example:
  1491.    
  1492.         "This string contains a \"Quoted string\""
  1493.    
  1494.      will yield
  1495.    
  1496.         This string contains a "Quoted string"
  1497.    
  1498.      Note:
  1499.         You cannot place a '\' at the end of a parameter using quotes. This
  1500.         appears to be a bug in the compilers runtime library.
  1501.    
  1502.         Alias does not process quotes, it passes them through verbatim.
  1503.    
  1504.         EnvEdit quotes are not subject to the above runtime library
  1505.         "bug/feature."
  1506.    
  1507.    
  1508.    Line editor
  1509.    -----------
  1510.      A simple line editor is provided in the Alias and EnvEdit tools. This
  1511.      editor allows you to perform the following actions:
  1512.    
  1513.         Up Arrow       Move one line up (multiple line display only)
  1514.         Down Arrow     Move one line down (multiple line display only)
  1515.         Left Arrow     Move one character to the left
  1516.         Right Arrow    Move one character to the right
  1517.         CTRL-Left      Move one word to the left
  1518.         CTRL-Right     Move one word to the right
  1519.         INSERT         Toggle Insert/Overstrike mode
  1520.         HOME     (^A)  Move to the beginning of the edit field
  1521.         END      (^E)  Move to the end of the edit field
  1522.         DELETE   (^D)  Delete the current character
  1523.         BACKSPACE      Delete the previous character
  1524.         CTRL-Y         Delete the entire line
  1525.         RETURN (ALT-X) Store changes and exit
  1526.         ESCAPE         Abort changes and exit
  1527.    
  1528.    
  1529.    
  1530.    
  1531.    
  1532.    
  1533.    
  1534.    
  1535.                                       -20-    Obs Toolkit 1.5                                        Getting Started
  1536.    
  1537.    ErrorLevels
  1538.    -----------
  1539.      A simple, but flexible policy on DOS ErrorLevels has been consistently
  1540.      applied to all tools. The higher the error level, the more critical the
  1541.      error was to the normal operation of the tool. At the bottom, or
  1542.      errorlevel 0, is "NO ERRORs", while at the top, errorlevel 6 is an
  1543.      "INSTALL" error, where the tool was unable to execute.
  1544.    
  1545.      The ErrorLevels are as follows:
  1546.    
  1547.      0 - NO ERROR         - No error encountered
  1548.      1 - NOT FOUND        - File or object was "NOT FOUND"
  1549.      2 - ABORTED          - The user chose to "ABORT" the operation
  1550.      3 - OPERATION FAILED - The requested "OPERATION FAILED"
  1551.      4 - LIMIT EXCEEDED   - The operation exceeded the tools "LIMIT"
  1552.      5 - USAGE ERROR      - The tool displayed a "USAGE" error
  1553.      6 - INSTALL FAILED   - The tool was unable to "INSTALL"
  1554.    
  1555.    
  1556.    Redirection support
  1557.    -------------------
  1558.      The Toolkit's tools are all aware of redirection. When you redirect a
  1559.      tools output the paging capabilities are automatically disabled. When
  1560.      you pipe input into FileDump, it accepts the input and paging is
  1561.      available.
  1562.    
  1563.    
  1564.    Options
  1565.    -------
  1566.       o Options may be placed on the command line in any order.
  1567.    
  1568.       o Options are processed from left to right.
  1569.    
  1570.       o Options must be separated by spaces except for MultiFile and
  1571.         ListFiles which do not require spaces.
  1572.    
  1573.       o Usually options may appear anywhere on the command line (after the
  1574.         tools name). For consistency in the examples provided, all options
  1575.         are placed before the user supplied arguments.
  1576.    
  1577.         Exceptions:
  1578.    
  1579.           o ALIAS will only accept /NOSPACE, /NULL, /MAKE and /EDIT options
  1580.             during an alias definition, and those options must be present
  1581.             before the name of the alias to be defined.
  1582.    
  1583.           o EE must have all options specified before the environment
  1584.             variable name. The last item on the line must be the variable
  1585.             name[=definition].
  1586.    
  1587.           o The above exceptions are required so that the options above can
  1588.             be passed along with the definition without being processed by
  1589.             the tool.
  1590.    
  1591.    
  1592.    
  1593.    
  1594.                                       -21-    Obs Toolkit 1.5                                        Getting Started
  1595.    
  1596.       o Throughout this document, options are defined in UPPER and lower
  1597.         case. The UPPER case portion is the minimum string recognized by the
  1598.         tools. The lower case is the remainder of the option name. The lower
  1599.         case portion is always optional, but if present must match.
  1600.    
  1601.       o Sometimes options are cumulative, and sometimes they are exclusive.
  1602.         This approach was selected so that you can customize the operation
  1603.         of a command using ALIAS and then override the selection when at the
  1604.         command line.
  1605.    
  1606.    Reading the Usage
  1607.    -----------------
  1608.       Parameters specified between '[' & ']' are optional. Their presence is
  1609.       not required (the specific operation is dictated by the particular
  1610.       tool).
  1611.    
  1612.       Parameters specified between '{' & '}' are repeatable.
  1613.    
  1614.       Parameters separated by a '|' are one or the other.
  1615.    
  1616.       You do not type the above symbols!
  1617.    
  1618.    Press any key...
  1619.    ----------------
  1620.       To pause a scrolling display you may specify /Page as an option, or
  1621.       press the <ESC> key during the scroll. Paging is automatically
  1622.       disabled when redirecting output.
  1623.    
  1624.       When the computer is waiting at the "Press any key to continue..."
  1625.       prompt, you may enter the <ESC> key for a continuous scroll, or any
  1626.       other key to view the next screenful.
  1627.    
  1628.       When FileDump is at "Press any key...":
  1629.          o A Carriage Return will advance a single line.
  1630.          o The percent of file viewed will be appended to the prompt.
  1631.          o If multiple files were selected for display:
  1632.            o The current filename will be appended to the prompt.
  1633.            o Issuing a CTRL-C will skip to the next file (if any).
  1634.    
  1635.    Help Screens
  1636.    ------------
  1637.       Items identified on the help screen with a '*' are default or normal
  1638.       operations.
  1639.    
  1640.       Items identified with a '+' are active positive; hence a '+' on OCD's
  1641.       /[NO]UPDATE option indicates /UPDATE. When a '+' is not present the
  1642.       switch is active negative (i.e., /NOUPDATE).
  1643.    
  1644.    
  1645.    
  1646.    
  1647.    
  1648.    
  1649.    
  1650.    
  1651.    
  1652.    
  1653.                                       -22-    Obs Toolkit 1.5                                                 ObsRes
  1654.    
  1655.              ObsRes (OBSRES), ReRes (RERES) & DirStack (DIRSTACK)
  1656.              ----------------------------------------------------
  1657.    
  1658.    ObsRes
  1659.    ------
  1660.      Description:
  1661.         ObsRes is a well behaved memory resident utility (TSR) that provides
  1662.         a central focal point to Obs Toolkit. All of Obs tools except for
  1663.         Alias will function without ObsRes, but some functionality will be
  1664.         lost.
  1665.    
  1666.         ObsRes complements DOSKEY by adding silent, abbreviated aliases and
  1667.         the DirStack. Even the multiple commands in the DOSKEY macros are
  1668.         translated by Obs aliases.
  1669.    
  1670.         ObsRes serves four (4) key functions:
  1671.    
  1672.            1) Performs the Alias translations from NAME to COMMAND
  1673.    
  1674.            2) Maintains the Alias dictionary in resident RAM
  1675.    
  1676.            3) Maintains the DirStack (directory stack) in resident RAM
  1677.    
  1678.            4) Offers DOT commands to control translator operations
  1679.    
  1680.         ====> ObsRes must be installed after any command line editors.
  1681.               Command line editors play around with the input and ObsRes
  1682.               will never see it.
  1683.    
  1684.               If it is necessary to load ObsRes before such a program, then
  1685.               you can use ReRes to get control back.
  1686.    
  1687.         If you use a DOS command line editor (many are available (DOSKEY is
  1688.         free with DOS 5)), then the recall buffer will contain the command
  1689.         that you typed. If you don't use a command line editor (why would
  1690.         you not?) then the command recall (F3) will contain the translated
  1691.         command.
  1692.    
  1693.         If you are using NDOS or 4DOS and you want to use Obs Aliases, then
  1694.         issue the SETDOS command with the /L1 option. This will inform NDOS
  1695.         and 4DOS to get keyboard input the same way that COMMAND.COM does.
  1696.         Your other option is to just install the DirStack. Aliases are
  1697.         provided for NDOS/4DOS in a file called XDOS.CFG.
  1698.    
  1699.         Each alias defined takes the number of characters defined plus five
  1700.         (5) bytes of overhead (four (4) on /NOSPACE definitions).
  1701.    
  1702.         Each DirStack entry takes up 67 bytes.
  1703.    
  1704.         The sum space requested is combined with ObsRes resident code to
  1705.         produce the resident space requirement. The actual amount of memory
  1706.         reserved for a TSR is variable depending upon the current
  1707.         environment block and the TSRs Drive:\Path\FileName.exe.
  1708.    
  1709.    
  1710.    
  1711.    
  1712.                                       -23-    Obs Toolkit 1.5                                                 ObsRes
  1713.    
  1714.      Usage:
  1715.        OBSRES [Dictionary size [DirStack Depth]]
  1716.    
  1717.      Options:
  1718.        Dictionary Size
  1719.           Specifies the number of bytes to retain for alias definitions.
  1720.           This directly affects the size of the resident image. For each 16
  1721.           bytes, 1 paragraph (16 bytes) is reserved.
  1722.    
  1723.           Minimum size - 128 bytes
  1724.              Hardly enough for anything serious.
  1725.    
  1726.           Maximum size - 4096 bytes
  1727.              More than enough for even the most serious. If this is not
  1728.              enough, then we apologize. The limit is there to inhibit the
  1729.              unaware from eating up too much memory. Send us a request,
  1730.              we'll grow to meet your needs.
  1731.    
  1732.           Default size - 2048 bytes
  1733.              A modest amount that will meet the needs of most users.
  1734.    
  1735.           TIP:
  1736.              Use ALIAS /STATUS to determine the slack space in the Alias
  1737.              dictionary.
  1738.    
  1739.    
  1740.        DirStack Depth
  1741.           Specifies the number of locations to be maintained on the
  1742.           directory stack.
  1743.    
  1744.           Minimum depth - 1 entry
  1745.              This allows you to return from whence you came and provides one
  1746.              (1) SmartPath.
  1747.    
  1748.           Maximum depth - 9 entries.
  1749.              This is a lot for even the most keen. This is a hard and fast
  1750.              limit. You can only use one letter to identify a disk, and all
  1751.              the characters are reserved by DOS.
  1752.    
  1753.           Default depth - 4 entries.
  1754.              This provides for ample POPs, and four (4) SmartPaths.
  1755.    
  1756.    
  1757.      Internal Commands:
  1758.        ObsRes has four (4) internal DOT commands to configure its operation.
  1759.        The internal commands are there to permit you to enable and disable
  1760.        certain features of the Toolkit during the customization process.
  1761.    
  1762.        .ON     -- Enable the translator
  1763.        .OFf    -- Disable the translator
  1764.        .Echo   -- Enable the translation echo
  1765.        .Noecho -- Disable the translation echo
  1766.    
  1767.    
  1768.    
  1769.    
  1770.    
  1771.                                       -24-    Obs Toolkit 1.5                                                 ObsRes
  1772.    
  1773.        The .ON and .OFF are particularly handy when optimizing system
  1774.        performance by setting the definition of the "OB" alias. If the
  1775.        response "Bad command or file name" occurs, because recursive aliases
  1776.        are installed incorrectly, then typing ".OFF" will place COMMAND.COM
  1777.        back into control.
  1778.    
  1779.        The .ECHO and .NOECHO can be used to see what the effect of the
  1780.        translation is, so that the bad command can be isolated and
  1781.        corrected.
  1782.    
  1783.        The ".COMMAND" operations are further described in ALIAS under their
  1784.        appropriate "/COMMAND". The ".COMMANDs" are not available in batch
  1785.        files.
  1786.    
  1787.        If you are having difficulty accessing aliased commands, then refer
  1788.        to Installation / Bad command or file name.
  1789.    
  1790.      Examples:
  1791.         OBSRES
  1792.            This will install ObsRes into memory with a default dictionary
  1793.            size of 2K and a default DirStack depth of 4 entries. The memory
  1794.            burden on your system will be roughly 4000 bytes.
  1795.    
  1796.         OBSRES 1024 9
  1797.            This will install ObsRes into memory with a dictionary size of 1K
  1798.            and a DirStack of 9 entries. The memory burden on your system
  1799.            will be roughly 3400 bytes.
  1800.    
  1801.      TIP:
  1802.         You can load ObsRes into High memory using an intelligent memory
  1803.         manager such as the ones provided by DOS 5, Quarterdeck or Qualitas.
  1804.         This will allow you to maximize your conventional memory.
  1805.    
  1806.         If don't want Obs aliases then use the stand-alone DirStack.
  1807.    
  1808.    
  1809.    
  1810.    
  1811.    
  1812.    
  1813.    
  1814.    
  1815.    
  1816.    
  1817.    
  1818.    
  1819.    
  1820.    
  1821.    
  1822.    
  1823.    
  1824.    
  1825.    
  1826.    
  1827.    
  1828.    
  1829.    
  1830.                                       -25-    Obs Toolkit 1.5                                                  ReRes
  1831.    
  1832.    ReRes
  1833.    -----
  1834.      Description:
  1835.         ReRes is also a memory resident utility. We discovered the need for
  1836.         it when we would shell into DOS from Windows/real mode and DESQview,
  1837.         only to discover that we had lost our aliases. The DirStack was
  1838.         still available and we could list aliases, but the commands just
  1839.         weren't getting swapped. We lost our powers, what a horror.
  1840.    
  1841.         The answer was to gen up a tiny utility (128 resident bytes) to get
  1842.         back into the driver's seat. This is about as small as a TSR can get
  1843.         without getting heavy into playing musical bytes.
  1844.    
  1845.         ReRes serves one (1) function:
  1846.    
  1847.            To regain aliases after you shell into a program that disables
  1848.            them.
  1849.    
  1850.         ====> ReRes can be installed to regain alias control after a program
  1851.               has hidden ObsRes.
  1852.    
  1853.         ObsRes must have previously been installed. ReRes works with ObsRes
  1854.         only.
  1855.    
  1856.         If ObsRes is still functional (not locked out) and not supporting
  1857.         DOSKEY when ReRes is installed, the effect will be to nest the
  1858.         application of aliases one level for each ReRes installed.
  1859.    
  1860.         If ObsRes is supporting DOSKEY when reres is installed, the effect
  1861.         will be to enable aliases for many programs that read input the same
  1862.         way the COMMAND.COM used to.
  1863.    
  1864.      Note: NDOS and 4DOS users
  1865.         ReRes cannot claim back the command line after these programs have
  1866.         been installed unless their SETDOS /L1 command is issued.
  1867.    
  1868.    
  1869.    
  1870.    
  1871.    
  1872.    
  1873.    
  1874.    
  1875.    
  1876.    
  1877.    
  1878.    
  1879.    
  1880.    
  1881.    
  1882.    
  1883.    
  1884.    
  1885.    
  1886.    
  1887.    
  1888.    
  1889.                                       -26-    Obs Toolkit 1.5                                               DirStack
  1890.    
  1891.    DirStack
  1892.    --------
  1893.      Description:
  1894.         Many of you may be using one of the popular alias programs available
  1895.         on the market, or using a COMMAND.COM replacement that won't support
  1896.         third party alias programs. To minimize the memory burden on systems
  1897.         that don't require the Obs alias translator, you can use this small
  1898.         utility to maintain a just a DirStack.
  1899.    
  1900.         DirStack provides you with an optional way to configure the system
  1901.         to minimize memory usage.
  1902.    
  1903.      Usage:
  1904.         DIRSTACK [DirStack Depth]
  1905.    
  1906.      Options:
  1907.         DirStack Depth
  1908.           Specifies the number of locations to be maintained on the
  1909.           directory stack.
  1910.    
  1911.           Minimum depth - 1 entry.
  1912.    
  1913.           Maximum depth - 9 entries.
  1914.    
  1915.           Default depth - 9 entries.
  1916.    
  1917.      Note:
  1918.         DirStack does not offer nor perform alias translations. If you want
  1919.         Obs aliases then use ObsRes.
  1920.    
  1921.    
  1922.    
  1923.    
  1924.    
  1925.    
  1926.    
  1927.    
  1928.    
  1929.    
  1930.    
  1931.    
  1932.    
  1933.    
  1934.    
  1935.    
  1936.    
  1937.    
  1938.    
  1939.    
  1940.    
  1941.    
  1942.    
  1943.    
  1944.    
  1945.    
  1946.    
  1947.    
  1948.                                       -27-    Obs Toolkit 1.5                                                  Alias
  1949.    
  1950.                                 Alias (ALIAS)
  1951.                                 -------------
  1952.    
  1953.      Description:
  1954.         ALIAS is a tool to allow synonyms to be created and executed as a
  1955.         part of DOS. It is a clean and easy way to build custom commands
  1956.         without having to resort to disk eating batch files.
  1957.    
  1958.         Commands can be as simple as
  1959.    
  1960.            1) Renaming a program to something you are more comfortable with
  1961.    
  1962.            2) Invoking a program that isn't in your path
  1963.    
  1964.            3) Invoking a program with certain options
  1965.    
  1966.            4) Bypassing internal commands to something a tad bit more usable
  1967.    
  1968.         Notes:
  1969.            ObsRes must be installed in order for ALIAS to operate.
  1970.    
  1971.            Aliases do not function in batch files. We haven't built that
  1972.            tool yet, so in your batch files you'll have to type out each
  1973.            command with the correct options selected.
  1974.    
  1975.            Aliases do not work in all DOS shells. To minimize this
  1976.            inconvenience ReRes reinstates aliases in shells that have
  1977.            disabled them. If you use DOSKEY then the next crop of
  1978.            applications should work fine.
  1979.    
  1980.            Aliases all come with spaces. If you do not want a space at the
  1981.            end of your alias, then you must prefix the definition with the
  1982.            /NOSPACE qualifier.
  1983.    
  1984.    
  1985.         Alias provides six (6) functions:
  1986.    
  1987.            1) Placing aliases into the dictionary (e.g., ALIAS name command)
  1988.    
  1989.            2) Outputting the dictionary in a form suitable for /FILE
  1990.               processing or batch files (e.g., ALIAS > name.bat)
  1991.    
  1992.               Note: Redirection will not store the comments which may be in
  1993.                     your alias definition file.
  1994.    
  1995.            3) Setting translation options (e.g., ALIAS /ON)
  1996.    
  1997.            4) Getting status on current translation options (ALIAS /STATUS)
  1998.    
  1999.            5) Editing existing aliases (ALIAS /EDIT name)
  2000.    
  2001.            6) Defines the translation skip character (ALIAS /SKIPCHAR 'x')
  2002.    
  2003.    
  2004.    
  2005.    
  2006.    
  2007.                                       -28-    Obs Toolkit 1.5                                                  Alias
  2008.    
  2009.      TIPS:
  2010.         Use Alias to build custom commands.
  2011.    
  2012.         Once an alias is defined, you can bypass it by preceding the command
  2013.         with the skip character. The skip character defaults to a space ' '
  2014.         unless changed. Assuming that DIR has been aliased (e.g., ALIAS dir
  2015.         LF) and that the skip character is still a space.
  2016.    
  2017.            C>DIR   - this would invoke the aliased DIR (lf)
  2018.            C> DIR  - this would invoke DOS's DIR
  2019.    
  2020.      Usage:
  2021.         ALIAS
  2022.            This displays all currently defined aliases.
  2023.    
  2024.         ALIAS name
  2025.            This displays the translation (if any) for NAME.
  2026.    
  2027.         ALIAS name*
  2028.            This displays the translation (if any) for all aliases begining
  2029.            with NAME.
  2030.    
  2031.         ALIAS [/NOSPACE] name command
  2032.            This defines an alias where NAME translates to COMMAND. Alias
  2033.            names can be abbreviated by using a single quote. All single
  2034.            quote characters are ignored during translation and should be
  2035.            only be used for indicating an abbreviation.
  2036.    
  2037.         ALIAS /NULL name
  2038.            This defines a null alias.
  2039.    
  2040.         ALIAS [options]
  2041.            The options are defined and described below.
  2042.    
  2043.      Options:
  2044.         /[NO]CAse - Observe case of alias names
  2045.            This option instructs the translator to view aliases as case
  2046.            sensitive. This means that cd != CD (is not equal to). The case
  2047.            of commands is always retained regardless of this option.
  2048.    
  2049.            Use /NOCASE to disable case sensitivity.
  2050.    
  2051.         /CLear - Delete all aliases
  2052.            This command deletes all aliases. When ObsRes is first installed
  2053.            the alias dictionary is clear.
  2054.    
  2055.         /Delete - Delete an alias
  2056.            Usage: ALIAS /DELETE name
  2057.    
  2058.            This removes an alias definition. If the alias does not exist
  2059.            then no error is reported.
  2060.    
  2061.    
  2062.    
  2063.    
  2064.    
  2065.    
  2066.                                       -29-    Obs Toolkit 1.5                                                  Alias
  2067.    
  2068.            TIP:
  2069.                Create an unalias command to remove aliases.
  2070.                   C>ALIAS unalias ALIAS /DELETE
  2071.    
  2072.         /[NO]ECho - Echo translations to the console
  2073.            This option instructs the translator to echo the translation
  2074.            command to the console whenever a substitution is made. The
  2075.            translation is output to the display just below the command line.
  2076.    
  2077.            This command is directly available as a ".COMMAND" from the
  2078.            command line (.ECHO).
  2079.    
  2080.            TIP:
  2081.                This can be useful to learn commands and their options.
  2082.    
  2083.                Echo can let you know when translations are occurring.
  2084.    
  2085.            Use /NOECHO to disable echo translations.
  2086.    
  2087.         /[NO]EDit - Edit the specified alias definition
  2088.            Usage: ALIAS /EDIT name
  2089.    
  2090.            This command will bring up a line editor to allow you to edit the
  2091.            current alias name/command pair. Using the line editor is simple
  2092.            and intuitive. Refer to "Getting Started / Line Editor" for a
  2093.            description of the line editor commands.
  2094.    
  2095.            TIP:
  2096.                When you want to make a change to an existing alias, don't
  2097.                redefine it; /EDIT it.
  2098.    
  2099.            Note:
  2100.                When you change the name of the alias, the old alias is
  2101.                deleted and the new alias is added.
  2102.    
  2103.         /File - Process alias commands from a file
  2104.            Usage: ALIAS [/CLEAR] /FILE filename.ext
  2105.    
  2106.            This option directs the alias generator to read the specified
  2107.            file and process the commands as if they were issued at the
  2108.            command line.
  2109.    
  2110.            DOS commands ECHO and REM are processed the same as DOS would.
  2111.    
  2112.               ECHO controls whether commands are echoed to the console or
  2113.               not and can be used to display messages to the console.
  2114.    
  2115.               REM can be used to place comments into the alias definition
  2116.               file.
  2117.    
  2118.            The DOS 3.3+ '@' command qualifier is processed also. It inhibits
  2119.            echo of the current line regardless of the ECHO state.
  2120.    
  2121.    
  2122.    
  2123.    
  2124.    
  2125.                                       -30-    Obs Toolkit 1.5                                                  Alias
  2126.    
  2127.            Alias definition files can be nested. The nesting limit is
  2128.            limited only by the maximum number of open files.
  2129.    
  2130.            Note:
  2131.               Unlike DOS batch processing, the initial ECHO mode for alias
  2132.               definition files when processed by the alias generator is ECHO
  2133.               OFF.
  2134.    
  2135.               If a line in the alias definition file is not understood by
  2136.               the alias generator, then an error message for that line will
  2137.               be posted. The line will be ignored and processing will
  2138.               continue with the next line.
  2139.    
  2140.               /CLEAR can be used to clear out the existing aliases before
  2141.               loading in the new set.
  2142.    
  2143.         /Make - Define a path alias
  2144.            Usage: ALIAS /MAKE name
  2145.    
  2146.            This option defines a path alias. The alias is defined to be
  2147.    
  2148.              ALIAS /NOSPACE name <current directory>\
  2149.    
  2150.            The command is provided so that the TRYIT.BAT program can provide
  2151.            direct access to the commands without knowing, in advance, which
  2152.            directory the Toolkit was placed into.
  2153.    
  2154.         /NOSpace - Do not add a space after the name when translating
  2155.            Usage: ALIAS /NOSPACE name cmd
  2156.    
  2157.            This option is valid during an alias definition only. Use of this
  2158.            option directs the translator not to place a space after the
  2159.            translation. This allows catenation of an alias with its
  2160.            supporting text.
  2161.    
  2162.            Example:
  2163.              C>ALIAS /NOSPACE chmod MF /SA
  2164.    
  2165.              C>chmod +r file.exe
  2166.    
  2167.              When CHMOD is issued at the command line the first command line
  2168.              argument will be directly appended to the translation. This
  2169.              yields (using the example above)
  2170.    
  2171.                C>MF /SA+r file.exe
  2172.    
  2173.         /NUll - Define a null alias
  2174.            Usage: ALIAS /NULL name
  2175.    
  2176.            This option allows you to define a NULL alias. One that
  2177.            translates to nothing. This option allows you to place a prefix
  2178.            before a command name and to disable it when necessary. This
  2179.            option needs recursion to be active in order to be effective.
  2180.    
  2181.    
  2182.    
  2183.    
  2184.                                       -31-    Obs Toolkit 1.5                                                  Alias
  2185.    
  2186.            Example:
  2187.               C>ALIAS /RECURSE
  2188.               C>ALIAS /NULL    ob
  2189.               C>ALIAS          ocd   ob ocd.exe
  2190.               C>ALIAS          cd    ocd
  2191.    
  2192.               When CD is typed at the command line, the command will be
  2193.               equivalent to C>OCD.EXE. If OB were to be defined as
  2194.    
  2195.                 C>ALIAS /NOSPACE ob c:\util\
  2196.    
  2197.               then, when CD is typed at the command line, the command will
  2198.               be equivalent to C>C:\UTIL\OCD.EXE
  2199.    
  2200.         /ON  - Enable translator     (default)
  2201.            This option returns the translator to its active state. If the
  2202.            translator was already active, then no change will occur.
  2203.    
  2204.            This command is also directly available as a ".COMMAND" from the
  2205.            command line (.ON).
  2206.    
  2207.         /OFf - Disable translator
  2208.            This option causes the translator to become passive. This may be
  2209.            handy if some program needs the aliased commands and it is not
  2210.            convenient to precede them by a space.
  2211.    
  2212.            This command is also directly available as a ".COMMAND" from the
  2213.            command line (.OFF).
  2214.    
  2215.            TIP:
  2216.                If ALIAS translations affect one of your programs adversely
  2217.                (keeps swapping your text), then use a batch file to turn the
  2218.                aliases off, execute your program and then turn the aliases
  2219.                on again.
  2220.    
  2221.         /[NO]Page - Page the output
  2222.            This instructs ALIAS to pause when outputting aliases and the
  2223.            screen is full.
  2224.    
  2225.         /[NO]Recurse - Recursively apply aliases
  2226.            This allows aliases to be defined in terms of other aliases.
  2227.            After an aliased command is translated, the translator will
  2228.            attempt to translate the new command.
  2229.    
  2230.            Use /NORECURSE to disable recursive alias translations.
  2231.    
  2232.            Note:
  2233.               The recursion process is limited to ten levels. If more than
  2234.               ten levels are detected, the translator will report an error
  2235.               and the command line will be ignored. This is to prevent an
  2236.               endless loop (when a command aliases back to itself).
  2237.    
  2238.    
  2239.    
  2240.    
  2241.    
  2242.    
  2243.                                       -32-    Obs Toolkit 1.5                                                  Alias
  2244.    
  2245.            TIP:
  2246.               Use recursive aliases to reduce program access time.
  2247.    
  2248.               Example:
  2249.                  C>ALIAS /RECURSE
  2250.                  C>ALIAS          dir     LF
  2251.                  C>ALIAS          bytime  LF /OD
  2252.                  C>ALIAS          lf      ob lf.exe
  2253.                  C>ALIAS /NOSPACE ob      c:\util\
  2254.    
  2255.                  When the DIR, or BYTIME command is issued, the translator
  2256.                  will use "c:\util\lf.exe ". This way, LF can be accessed
  2257.                  immediately without DOS having to search the PATH.
  2258.    
  2259.                  You can verify this performance advantage by using
  2260.                     C>LOCATE dir
  2261.    
  2262.                  You can see the translation passed to the command line by
  2263.                  enabling the /ECHO feature.
  2264.    
  2265.                  The performance advantage may not be so noticeable if you
  2266.                  are using good disk caching software or a very fast disk.
  2267.    
  2268.         /SKipchar - Define the "Skip Translation" character
  2269.            Usage: ALIAS /SKIPCHAR "x"
  2270.    
  2271.            This command defines the single character which signals to the
  2272.            alias translator that no translation should occur. The skip
  2273.            character can be enclosed in double, single, or no quotes.
  2274.    
  2275.            The skip character can be used to accomplish two different
  2276.            things.
  2277.    
  2278.              1) At the command line you can stop a translation from
  2279.                 occuring.
  2280.    
  2281.              2) In an alias definition you can stop recursion. Assume that
  2282.                 the skip character has been set to '!', then the following
  2283.                 would no longer be recursive:
  2284.    
  2285.                    ALIAS LF !LF /P
  2286.    
  2287.         /STatus - Get current status of the alias translator
  2288.            Display the mode that the alias translator is working in. The
  2289.            status information tells whether the translator is active or
  2290.            passive (on or off); whether or not the translator is case
  2291.            sensitive; whether or not translation echoes are being performed;
  2292.            whether or not aliases are being applied recursively; the current
  2293.            skip character; the number of aliases defined and the amount of
  2294.            free space available in the translator's buffer.
  2295.    
  2296.    
  2297.    
  2298.    
  2299.    
  2300.    
  2301.    
  2302.                                       -33-    Obs Toolkit 1.5                                                  Alias
  2303.    
  2304.      Examples:
  2305.         C>ALIAS unalias ALIAS /DELETE
  2306.           This defines UNALIAS to be equivalent to ALIAS /DELETE. Whenever
  2307.           you want to delete an alias just type UNALIAS CMD.
  2308.    
  2309.         C>ALIAS > aliases.bat
  2310.           This uses DOS redirection to create a batch file that saves the
  2311.           current aliases and alias translator settings. The batch file can
  2312.           be executed later to add these aliases back into the translation
  2313.           table. If you chose to keep comments in your alias definition
  2314.           file, then it is better to use an editor to add permanent aliases.
  2315.           Redirection does not store comments.
  2316.    
  2317.           TIP:
  2318.             Use DOS redirection to save your aliases in a batch file.
  2319.               C>ALIAS > myalias.bat
  2320.    
  2321.               That file can be processed by DOS (as a batch file) or by
  2322.               ALIAS using the /FILE option. Letting ALIAS process the file
  2323.               is significantly quicker.
  2324.    
  2325.           TIP:
  2326.             Place ObsRes in your AUTOEXEC.BAT file (after DOSKEY or other
  2327.             command line editors) and then call the alias definition file
  2328.             (which you create) with ALIAS /FILE so that the aliases that you
  2329.             want to keep are available each time you reboot or power-up your
  2330.             machine.
  2331.    
  2332.         C>ALIAS /STATUS
  2333.           This tells you what the current configuration the translator is
  2334.           executing under. It reports translator conditions such as:
  2335.    
  2336.             o Case sensitivity (on / off)
  2337.             o Translator (on / off)
  2338.             o Recursion (on / off)
  2339.             o Echo (on / off)
  2340.             o Current skip character
  2341.             o Number of aliases defined
  2342.             o Size and space available in alias dictionary
  2343.    
  2344.         C>ALIAS /NOSPACE ob c:\util\
  2345.           This will define an alias named OB. The alias definition is
  2346.           special in that when a translation occurs it will not append a
  2347.           space after the translated text.
  2348.    
  2349.         C>ALIAS lf ob lf.exe
  2350.           Using the OB alias definition above and recursive aliases, the
  2351.           translation for LF will be C:\UTIL\LF.EXE. This principle is
  2352.           applied to all of Obs Toolkit commands that are supplied in the
  2353.           recursive alias definition file.
  2354.    
  2355.    
  2356.    
  2357.    
  2358.    
  2359.    
  2360.    
  2361.                                       -34-    Obs Toolkit 1.5                                                  Alias
  2362.    
  2363.         C>ALIAS /NULL ob
  2364.           This would cause the translation of OB to be nothing. Using the LF
  2365.           definition immediately above and recursive aliases, the
  2366.           translation of LF will be LF.EXE. The use of the NULL qualifier
  2367.           allows you to revert back to path searching when invoking aliased
  2368.           commands.
  2369.    
  2370.         C>ALIAS unalias
  2371.           This will show you the translation of UNALIAS if it exists. If
  2372.           UNALIAS does not exist, then no operation will be performed.
  2373.    
  2374.         C>ALIAS go'to locate /command /change
  2375.           This is an abbreviated alias that will go to the directory where
  2376.           an external command is found. Being an abbreviated alias you can
  2377.           enter the command using (GO, GOT, or GOTO).
  2378.    
  2379.         C>ALIAS a*
  2380.           This will show you the translations for all aliases that start
  2381.           with the letter 'A'.
  2382.    
  2383.      Notes:
  2384.         If you are more comfortable with case sensitive aliases, then use
  2385.         the /CASE switch.
  2386.    
  2387.         Note:
  2388.           If you do switch from CASE to NOCASE then the NAME with the
  2389.           nearest upper-case character will take precedence over the NAME
  2390.           without. When you switch back from NOCASE to CASE, order will be
  2391.           returned.
  2392.    
  2393.           => The above rule is true even when you redefine or delete an
  2394.              alias name.
  2395.    
  2396.         The alias dictionary size defaults to 2K bytes but can be set via
  2397.         ObsRes at its installation time.
  2398.    
  2399.         Default configuration for the translator is:
  2400.            1) Case insensitive
  2401.            2) Echo disabled
  2402.            3) Translator active
  2403.            4) Recursion disabled
  2404.            5) Skip character is a ' ' (space)
  2405.    
  2406.         Alias NAMEs cannot contain any of the following characters:
  2407.    
  2408.           (space comma tab / \ | [ ] , ; " + = )
  2409.    
  2410.         in addition, the appearence of any of the above characters on the
  2411.         command line will terminate the alias.
  2412.    
  2413.    
  2414.    
  2415.    
  2416.    
  2417.    
  2418.    
  2419.    
  2420.                                       -35-    Obs Toolkit 1.5                                                DirSize
  2421.    
  2422.                                  DirSize (DS)
  2423.                                  ------------
  2424.    
  2425.      Description:
  2426.         DirSize provides a pictorial tree of directories and sub-directories
  2427.         but adds little twists.
  2428.    
  2429.         DirSize /SIZE counts the files and space allocated (in clusters) to
  2430.         each directory. DirSize /DATE displays the creation dates of each
  2431.         directory.
  2432.    
  2433.         You can sort the tree by name, size, or date.
  2434.    
  2435.         Hidden directories are displayed in lower case.
  2436.    
  2437.      Usage:
  2438.         DS [options] [drive][directory]
  2439.    
  2440.      Options:
  2441.         /BYDAte - Chronological sort
  2442.            Display the tree branches in chronological order.
  2443.    
  2444.         /BYDOs - No sort (default)
  2445.            In default DOS order.
  2446.    
  2447.         /BYName - Alphabetical sort
  2448.            Display the tree branches in alphbetical order.
  2449.    
  2450.         /BYSize - Disk usage sort
  2451.            Display the tree branches from the largest to the smallest.
  2452.    
  2453.         /[NO]Count - Continue the Count
  2454.            Usage: DS /COUNT /DEPTH num dirname
  2455.    
  2456.            When the directory tree is abbreviated to a specific depth (see
  2457.            /DEPTH), counting is also suspended at that depth.
  2458.    
  2459.            You may want to have accurate results but are not interested in
  2460.            having the tree drawn out to umpteen levels. By using this
  2461.            option, DirSize yields correct results even if the tree is
  2462.            abbreviated.
  2463.    
  2464.         /[NO]DAte - Display directory creation date
  2465.            Usage: DS /DATE
  2466.    
  2467.            This option causes the tree to contain the creation date of the
  2468.            directory.
  2469.    
  2470.            This option may be combined with /SIZE, but the screen may get a
  2471.            little cluttered.
  2472.    
  2473.    
  2474.    
  2475.    
  2476.    
  2477.    
  2478.    
  2479.                                       -36-    Obs Toolkit 1.5                                                DirSize
  2480.    
  2481.         /DEpth - Limit depth of tree
  2482.            Usage: DS /DEPTH num
  2483.    
  2484.            When you have a lot of sub-directories, you may not want to see
  2485.            the tree draw them all. Using this option abbreviates the tree to
  2486.            the specified depth.
  2487.    
  2488.            A consequence of abbreviating the tree is that the sizes may be
  2489.            incorrect. Abbreviated trees are indicated by the appearance of
  2490.            an asterisk '*' next to the file count. The asterisk indicates
  2491.            that there were more sub-directories in the branch.
  2492.    
  2493.            If it is important to have the sub-directories counted, but you
  2494.            don't want them in the pictorial tree, then combine the Depth
  2495.            parameter with the Continue Count option (see /COUNT).
  2496.    
  2497.         /[NO]Page - Page output
  2498.            Page the directory tree out, one screenful at a time. Paging is
  2499.            25/43/50 line aware.
  2500.    
  2501.         /[NO]Size - Display directory size (Default operation)
  2502.            Usage: DS /DATE /SIZE
  2503.    
  2504.            Display size information of the directories in the tree.
  2505.    
  2506.            The size information contains the sum space of a directory, all
  2507.            of its' sub-directories, the space allocated to this directory
  2508.            alone, and the number of files in the directory.
  2509.    
  2510.            Finally a summary on the disk space allocated to the root of the
  2511.            tree, and disk space available on disk is reported in both bytes
  2512.            and as a percentage of total disk space.
  2513.    
  2514.      TIPS:
  2515.         When you need to free up some disk space, use DirSize /SIZE to
  2516.         pinpoint a directory that will give you the amount that you need.
  2517.    
  2518.         Use DirSize to get a pictorial representation of the directory tree
  2519.         structure.
  2520.    
  2521.         If you always want output that is paged, then use Obs Alias
  2522.         generator to redefine the DS command to include the options.
  2523.    
  2524.           C>ALIAS ds DS /PAGE
  2525.    
  2526.      Examples:
  2527.         C>DS
  2528.           Outputs an unsorted DirSize size tree rooted at the current
  2529.           directory.
  2530.    
  2531.         C>DS /NOSIZE /BYNAME
  2532.           Outputs a bare tree rooted at the current directory which was
  2533.           sorted to be in alphbetical order.
  2534.    
  2535.    
  2536.    
  2537.    
  2538.                                       -37-    Obs Toolkit 1.5                                                DirSize
  2539.    
  2540.         C>DS /PAGE
  2541.           Outputs a DirSize size tree starting at the current directory.
  2542.           Output is paged for easy viewing.
  2543.    
  2544.         C>DS /DEPTH 2 c:\
  2545.           Outputs a DirSize size tree for the C: Drive, starting at the root
  2546.           directory. The tree will be to two (2) sub-directories deep.
  2547.           Remember that in this case, the size information may be incorrect
  2548.           because DirSize didn't look into the child directories of the
  2549.           branches beyond Depth level three (3).
  2550.    
  2551.         C>DS /DEPTH 2 /COUNT c:\
  2552.           Same as the previous example, except that the size information is
  2553.           correct because DirSize Continued to Count files, but only drew
  2554.           the tree to two sub-directories.
  2555.    
  2556.         C>DS /DATE
  2557.           Outputs a DirSize date tree starting at the current directory.
  2558.    
  2559.      Notes:
  2560.         Using the Depth option without the Continue to Count will not
  2561.         produce total directory size information if the tree contains
  2562.         branches beyond the specified depth level.
  2563.    
  2564.         Using the Depth option can speed up tree operations on disks with a
  2565.         lot of sub-directories.
  2566.    
  2567.      Kudos:
  2568.         Gus Vendito, executive editor PC Magazine, stated to CompuServe
  2569.         magazine (Nov 1990, MS-DOS special insert), that DirSize was his
  2570.         favorite unique utility.
  2571.    
  2572.    
  2573.    
  2574.    
  2575.    
  2576.    
  2577.    
  2578.    
  2579.    
  2580.    
  2581.    
  2582.    
  2583.    
  2584.    
  2585.    
  2586.    
  2587.    
  2588.    
  2589.    
  2590.    
  2591.    
  2592.    
  2593.    
  2594.    
  2595.    
  2596.    
  2597.                                       -38-    Obs Toolkit 1.5                                                EnvEdit
  2598.    
  2599.                                  EnvEdit (EE)
  2600.                                  ------------
  2601.    
  2602.      Description:
  2603.         EnvEdit enables you to modify the DOS environment blocks. It comes
  2604.         with a line editor to simplify many mundane command line tasks, and
  2605.         comes with a batchable editor to allow streamlined system operation.
  2606.    
  2607.         EnvEdit is capable of editing the active environment block, the
  2608.         invoking parents environment block, the DOS master / root
  2609.         environment block, and even the environment block created just for
  2610.         it.
  2611.    
  2612.         Soon you'll wonder how you ever got along without it.
  2613.    
  2614.         TIPS:
  2615.            Redefine the PATH statement to automatically invoke the editor.
  2616.    
  2617.               C>ALIAS /NOSPACE  path   EE /EDIT /NOREMOVE path=
  2618.    
  2619.            This will permit your PATH command to act as normal but with one
  2620.            exception. Normally when PATH is typed at the command line all by
  2621.            itself, DOS would display the active path. Now PATH will bring up
  2622.            a line editor which permits you to view or make changes
  2623.            interactively.
  2624.    
  2625.            Use the batching capabilities to add and remove path portions
  2626.            when batching to a program that requires access to the path. This
  2627.            will allow shorter paths, providing more system memory, and
  2628.            decreasing search time to commands on the path.
  2629.    
  2630.      Usage:
  2631.         EE [options] [variable[=string]]
  2632.    
  2633.         Entering EE without a variable will display all currently defined
  2634.         environment variables.
  2635.    
  2636.         Entering "EE var=" will remove the definition for the environment
  2637.         variable VAR. Note: This can be inhibited by using the /NOREMOVE
  2638.         qualifier.
  2639.    
  2640.      Options:
  2641.         /Append - Add the following text
  2642.            Usage: EE /APPEND "text" variable
  2643.    
  2644.            This command, useful during batch files, will append the
  2645.            specified text to the end of the variables value.
  2646.    
  2647.         /[NO]CAse - Variable name is case sensitive (default /NOCASE)
  2648.            Usage: EE /CASE variable[=string]
  2649.    
  2650.            This option determines whether the variable name is considered
  2651.            case sensitive or not.
  2652.    
  2653.    
  2654.    
  2655.    
  2656.                                       -39-    Obs Toolkit 1.5                                                EnvEdit
  2657.    
  2658.         /CLear - Clear out the environment
  2659.            This command will clear out the environment and leave only the
  2660.            COMSPEC and a null PATH. This is what the environment looks like
  2661.            before you add things to it.
  2662.    
  2663.            If /CLEAR is combined with /SAVE or /LOAD then its operation will
  2664.            take place after /SAVE and/or before /LOAD.
  2665.    
  2666.         /COpy - Copy one variable into another
  2667.            Usage: EE /COPY target source
  2668.    
  2669.            Make a duplicate of an environment variable.
  2670.    
  2671.            If /COPY is combined with any other operations, then a copy of
  2672.            the environment variable will be made before the other operations
  2673.            are carried out.
  2674.    
  2675.         /CUrrent - Use the current environment block
  2676.            This is the environment block allocated to EE itself. Any changes
  2677.            made to this environment block will be lost as soon as EE
  2678.            terminates.
  2679.    
  2680.            Software developers will find this feature handy when
  2681.            constructing custom environment blocks for shells, and want to
  2682.            speed development.
  2683.    
  2684.            Note:
  2685.               /CURRENT does not provide any benefit to the casual user.
  2686.    
  2687.         /DECrement - Subtract one from the variable
  2688.            Usage: EE /DECREMENT variable
  2689.    
  2690.            This command will set the contents of variable to variable-1. The
  2691.            contents of the variable must be an integer number.
  2692.    
  2693.         /DELete - Delete the variable
  2694.            Usage: EE /DELETE variable
  2695.    
  2696.            This command will delete the specified environment variable.
  2697.    
  2698.            This command is for those users that are not comfortable with
  2699.               C>SET TEMP=
  2700.            to delete the environment variable TEMP, and for those who have
  2701.            used the /NOREMOVE switch as a default.
  2702.    
  2703.         /DOs - Use the current DOS environment block (DEFAULT)
  2704.            This is environment block that COMMAND.COM will pass to each
  2705.            program that it invokes. This will normally be the environment
  2706.            block that you want to modify.
  2707.    
  2708.    
  2709.    
  2710.    
  2711.    
  2712.    
  2713.    
  2714.    
  2715.                                       -40-    Obs Toolkit 1.5                                                EnvEdit
  2716.    
  2717.         /[NO]Edit - Enable / Disable editor (default /NOEDIT)
  2718.            Use of this option will bring up a line editor on the contents of
  2719.            the environment variable. The environment variable and definition
  2720.            are limited to the amount of environment space available or 512
  2721.            characters for the single environment variable, whichever is
  2722.            less.
  2723.    
  2724.            Refer to Getting Started / Line Editor for a description of the
  2725.            line editor.
  2726.    
  2727.         /INCrement - Add one to the variable
  2728.            Usage: EE /INCREMENT variable
  2729.    
  2730.            This command will set the contents of variable to variable+1. The
  2731.            contents of the variable must be an integer number.
  2732.    
  2733.         /INSert - Insert the following text
  2734.            Usage: EE /INSERT "text" variable
  2735.    
  2736.            This command, useful during batch files, will insert the
  2737.            specified text onto the beginning of the variables value.
  2738.    
  2739.         /LOAd - Load environment from a file
  2740.            Usage: EE [/CLEAR] /LOAD filename.ext
  2741.    
  2742.            This command will load/modify the variable definitions with the
  2743.            contents of the specified file. You can optionally /CLEAR the
  2744.            environment before loading it.
  2745.    
  2746.         /LOWer - Change variable contents to all lower case
  2747.            Usage: EE /LOWER variable
  2748.    
  2749.            This command makes the contents of variable to be all lower case.
  2750.    
  2751.            This command does not work on the PATH variable. The PATH must
  2752.            always be in upper case.
  2753.    
  2754.         /MAKe - Define a path environment variable
  2755.            Usage: EE /MAKE variable
  2756.    
  2757.            This command will define an environment variable to be the name
  2758.            of the current working directory and disk.
  2759.    
  2760.         /MASter - Use the master environment block
  2761.            The MASTER environment block is the environment block created
  2762.            when DOS first boots. This is the environment block that the
  2763.            AUTOEXEC.BAT modifies.
  2764.    
  2765.            The size of this environment block is fixed (normally 160 bytes,
  2766.            256 for DOS 5), but can be set by using a DOS SHELL command in
  2767.            your CONFIG.SYS file (/E: specifies number of bytes).
  2768.    
  2769.               SHELL=[path]COMMAND.COM [path] /E:256 /P
  2770.    
  2771.    
  2772.    
  2773.    
  2774.                                       -41-    Obs Toolkit 1.5                                                EnvEdit
  2775.    
  2776.         /Parent - Use the environment block of the parent
  2777.            The parent environment is the environment block that created the
  2778.            currently active "/DOS" environment block. If you use a menu
  2779.            driven dispatch program to insulate you from the command line,
  2780.            then the PARENT environment would be the environment block that
  2781.            belongs to the dispatch program.
  2782.    
  2783.         /[NO]REMove - Remove on null definition (default /REMOVE)
  2784.            Use of /NOREMOVE option will inhibit deletion of the variable
  2785.            when a null assignment is made "EE VAR=". This options importance
  2786.            can be seen when you want to set the PATH command up as an
  2787.            automatic edit, yet you also want the ability to set the PATH
  2788.            directly "PATH dir1;dir2;..."
  2789.    
  2790.         /REName - Change the name of the environment variable
  2791.            Usage: EE /RENAME newname oldname
  2792.    
  2793.            This command allows you to change the name of an environment
  2794.            variable.
  2795.    
  2796.         /REPlace - Replace the following text
  2797.            Usage: EE /REPLACE "current" "new" variable
  2798.    
  2799.            The REPLACE command allows you to replace a group of text in a
  2800.            variables definition with another group of text (possibly null).
  2801.    
  2802.            REPLACE is Case Sensitive.
  2803.    
  2804.            To delete a section from an environment variable, you can replace
  2805.            it with nothing.
  2806.    
  2807.         /ROot - Use the master environment block
  2808.            See /MASTER. /ROOT and /MASTER refer to the same environment
  2809.            block.
  2810.    
  2811.         /SAve - Store the environment into a file
  2812.            Usage: EE /SAVE filename.ext
  2813.    
  2814.            This command will save the environment into a file.
  2815.    
  2816.            The environment will be saved before the /CLEAR, /LOAD or any
  2817.            other operation modifies it.
  2818.    
  2819.         /[NO]STatus - Status about environment block (default /NOSTATUS)
  2820.            This option requests a status report on the selected environment
  2821.            block. The status report indicates the address and size of the
  2822.            environment block, and the number of bytes available in the
  2823.            environment block.
  2824.    
  2825.         /[NO]Quiet - Display output (defalut is /NOQUIET)
  2826.            This option instructs EnvEdit not to output the contents of the
  2827.            environment variable, or an error message if the environment
  2828.            variable is not found.
  2829.    
  2830.    
  2831.    
  2832.    
  2833.                                       -42-    Obs Toolkit 1.5                                                EnvEdit
  2834.    
  2835.            This works great in a batch file to determine if an environment
  2836.            variable is defined.
  2837.    
  2838.         /Upper - Change variable contents to all upper case
  2839.            Usage: EE /UPPER variable
  2840.    
  2841.            This command makes the contents of the variable to be all upper
  2842.            case.
  2843.    
  2844.      Notes:
  2845.         Because of DOS limitations (prior to DOS 5.0), when you shell or run
  2846.         a batch file, and you attempt to add characters to your environment
  2847.         block, you may occasionally get "Out of environment space." This is
  2848.         not a flaw in EE, but a limitation of DOS. DOS shrinks the
  2849.         environment block down to minimum size whenever it creates a new
  2850.         process. By definition this means that there is only a small amount
  2851.         of space from which to work (16 bytes or less).
  2852.    
  2853.         The out of space problem can be worked around by declaring
  2854.         placeholders in your root environment and deleting them when you
  2855.         shell or batch. Any space that you make available will be available
  2856.         for your use.
  2857.    
  2858.         The out of space problem plagues DOS's own SET command when invoked
  2859.         in a batch file, but plagues only EE when invoked from the command
  2860.         line.
  2861.    
  2862.      TIPS:
  2863.         Define the following commands:
  2864.            ALIAS          set    EE /EDIT
  2865.            ALIAS /NOSPACE path   EE /NOREMOVE /EDIT path=
  2866.            ALIAS /NOSPACE prompt EE /NOREMOVE /EDIT prompt=
  2867.    
  2868.      Trick:
  2869.         You can use EnvEdit editing capabilities to generate a PATH longer
  2870.         than you could using the command line.
  2871.    
  2872.      Examples:
  2873.         Using PATH=C:\DOS;C:\UTIL;
  2874.    
  2875.           If you wanted to add C:\WINDOWS to the end, you would use
  2876.              C>EE /APPEND c:\windows; path
  2877.    
  2878.              This would set PATH=C:\DOS;C:\UTIL;c:\windows;
  2879.    
  2880.           If you wanted to add C:\WINDOWS to the beginning, you would use
  2881.              C>EE /INSERT c:\windows; path
  2882.    
  2883.              This would set PATH=c:\windows;C:\DOS;C:\UTIL;
  2884.    
  2885.         Using PATH=C:\DOS;c:\util;C:\WINDOWS;
  2886.           If you want to delete C:\UTIL, you would use
  2887.              C>EE /REPLACE "c:\util;" "" path
  2888.    
  2889.              This would set PATH=C:\DOS;C:\WINDOWS;
  2890.    
  2891.    
  2892.                                       -43-    Obs Toolkit 1.5                                                EnvEdit
  2893.    
  2894.         C>EE /DELETE temp
  2895.           This will delete TEMP.
  2896.    
  2897.         C>EE /EDIT path
  2898.           This will bring up a line editor on PATH.
  2899.    
  2900.         C>EE /COPY temp path=c:\util
  2901.           This will make a duplicate of the current PATH into a new variable
  2902.           named TEMP. EnvEdit will then modify the PATH to be just C:\UTIL.
  2903.    
  2904.         EnvEdit Batch looping
  2905.         ---------------------
  2906.         This is an example of looping in a batch file (decrementing):
  2907.    
  2908.               rem Set count to the number of iterations through the loop
  2909.               EE count=10
  2910.           :TOP
  2911.               rem do something useful (this will be executed 10 times)
  2912.               rem ...
  2913.               rem ...
  2914.               EE /DECREMENT count
  2915.               if not %count% == 0 goto top
  2916.               EE /DELETE count
  2917.    
  2918.    
  2919.         EnvEdit Batch parameter testing
  2920.         -------------------------------
  2921.         This is an example of testing a batch parameter:
  2922.    
  2923.               rem Copy the variable and change the copies case to UPPER
  2924.               EE /UPPER tmp=%1
  2925.               if %tmp%. == OBS. goto yes
  2926.               echo %1 is not (obs obS oBs Obs oBS ObS OBs OBS)
  2927.               goto done
  2928.           :YES
  2929.               echo %1 is a variant of OBS
  2930.           :DONE
  2931.               EE /DELETE tmp
  2932.    
  2933.    
  2934.         EnvEdit Batch environment save & restore example
  2935.         ------------------------------------------------
  2936.         This is an example of saving and restoring an environment in a batch
  2937.         file:
  2938.    
  2939.               rem Save and clear the environment
  2940.               EE /SAVE env.fil /CLEAR
  2941.               rem You now have an empty environment from which to work
  2942.               rem ...
  2943.               rem (be sure to use fully qualified filenames)
  2944.               rem ...
  2945.               rem Restore the previous environment
  2946.               EE /CLEAR /LOAD env.fil
  2947.    
  2948.    
  2949.    
  2950.    
  2951.                                       -44-    Obs Toolkit 1.5                                               FileDump
  2952.    
  2953.                                  FileDump (FD)
  2954.                                  -------------
  2955.      Description:
  2956.         FileDump is a universal / versatile file viewer. The display can be
  2957.         selected to be TEXT (like DOS TYPE), or ASCII (new and unique), or
  2958.         HEX (like a debug dump).
  2959.    
  2960.         Other operations it can do is to count characters, words, lines, and
  2961.         pages; display only strings of a user specified length; start and/or
  2962.         stop anywhere in the file (by byte or line); number output lines;
  2963.         and more.
  2964.    
  2965.         FileDump is capable of viewing/converting files from UNIX and
  2966.         Macintosh formats.
  2967.    
  2968.      Usage:
  2969.         FD [options] { [SmartPath] [Directory] WildSpec }
  2970.    
  2971.         Files are always presented in sorted order. Sorting is performed on
  2972.         a WildSpec by WildSpec basis. In other words
  2973.    
  2974.           C>FD *.txt *.doc
  2975.    
  2976.         will sort the .TXT files and display them, and then sort the .DOC
  2977.         files and display them.
  2978.    
  2979.         While viewing output you can perform the following operations:
  2980.           o When text is scrolling:
  2981.             o <Escape> will Enter/Exit paging mode
  2982.             o Control-O will suppress output, press any key to return to
  2983.               normal output (this will advance you through the file(s))
  2984.             o When in paging mode any key will freeze output
  2985.    
  2986.           o When you are at a "Press any key..." prompt:
  2987.             o <Enter> will advance one line
  2988.             o <Escape> will exit paging mode
  2989.             o Control-C will skip to the end of file
  2990.             o any other key will advance one screenful
  2991.    
  2992.      Options:
  2993.         /7 - 7 Bit ASCII
  2994.           Strip and discard the Most Significant Bit from each character.
  2995.    
  2996.         /8 - 8 Bit ASCII
  2997.           Do not modify the incoming characters.
  2998.    
  2999.         /Ascii - Report only ASCII characters.
  3000.           Non-ASCII characters are reported as spaces.
  3001.    
  3002.           The /COMPRESS option will compress runs of non-ASCII characters to
  3003.           a single space.
  3004.    
  3005.    
  3006.    
  3007.    
  3008.    
  3009.    
  3010.                                       -45-    Obs Toolkit 1.5                                               FileDump
  3011.    
  3012.           The /SMART option will translate Carriage-Return / Line-Feed
  3013.           pairs, and expand tabs. This enables an all ASCII text file to be
  3014.           displayed normally.
  3015.    
  3016.           With /NOSMART the /BEGIN and /END offsets are in bytes.
  3017.    
  3018.           With /SMART the /BEGIN and /END offsets are in lines.
  3019.    
  3020.         /BEgin # - Set the start offset for output (default is 0)
  3021.           Usage: FD /BEGIN [-]count[x] { WildSpec }
  3022.    
  3023.           A positive number (absolute or relative (e.g., 5, or +5)),
  3024.           indicates that the output should start at unit 5. Hex offsets can
  3025.           be provided by appending an 'x' to the end of the number.
  3026.    
  3027.           A negative number (e.g., -10), indicates that the output should
  3028.           start 10 units before the end of the file.
  3029.    
  3030.           A unit is either a byte or line, depending on the selected output
  3031.           mode.
  3032.    
  3033.         /BInary - Open file as binary
  3034.           This option forces the file to be opened in binary mode instead of
  3035.           text mode.
  3036.    
  3037.           Example:
  3038.              To create a file catenator use FD
  3039.                 ALIAS cat FD /BINARY /TEXT
  3040.              Then CAT will glue files together
  3041.                 CAT part1.fil part2.fil part3.fil > complete.fil
  3042.    
  3043.         /[NO]COMpress - Compress runs (default is /NOCOMPRESS)
  3044.           This option compresses runs to singles. It's specific operation
  3045.           depends on the output mode selected.
  3046.    
  3047.           If the output mode is /ASCII, runs of non-ASCII chars are
  3048.           compressed to a single space.
  3049.    
  3050.           If the output mode is /TEXT, runs of Carriage-Return / Line-Feeds
  3051.           are compressed to a single line.
  3052.    
  3053.           If the output mode is /HEX, runs of identical output lines are
  3054.           replaced with a line containing an ellipses.
  3055.    
  3056.         /COUnt - Count items
  3057.           This command causes FileDump to count the number of characters,
  3058.           words, lines and pages in a file.
  3059.    
  3060.           The default page size is 66 lines.
  3061.    
  3062.           If non-ASCII characters are detected, then FileDump will report
  3063.           the condition along with its best guess results.
  3064.    
  3065.           The /BINARY option can be used to count a non-ascii file.
  3066.    
  3067.           The /BEGIN and /END offsets are in bytes.
  3068.    
  3069.                                       -46-    Obs Toolkit 1.5                                               FileDump
  3070.    
  3071.    
  3072.         /End - Set the end offset for output (default End-of-File)
  3073.           Usage: FD /END [-]count[x] { WildSpec }
  3074.    
  3075.           A positive absolute number (e.g., 5), indicates that the output
  3076.           should stop at unit 5. Hex offsets can be provided by appending an
  3077.           'x' to the end of the number.
  3078.    
  3079.           A positive relative number (e.g., +5), indicates that the output
  3080.           should stop at unit begin + 5; hence +n is begin unit + n
  3081.           additional units.
  3082.    
  3083.           A negative number (e.g., -10), indicates that the output should
  3084.           stop 10 units before the end of the file.
  3085.    
  3086.           A unit is either a byte or a line, depending on the selected
  3087.           output mode.
  3088.    
  3089.         /Hex - Hexadecimal dump
  3090.           This command causes FileDump to display the contents of the source
  3091.           file as a Hexadecimal dump.
  3092.    
  3093.           The /COMPRESS will compress identical lines to a one line, and a
  3094.           line of ellipses.
  3095.    
  3096.           The /BEGIN and /END offsets are in bytes. You can use hex offsets
  3097.           by appending an 'x' to the number.
  3098.    
  3099.           The /SMART will enable display of extended ASCII characters.
  3100.    
  3101.           The /7 & /8 have no effect on HEX output.
  3102.    
  3103.         /[NO]NUmber - Number text lines (default is /NONUMBER)
  3104.           This causes the output lines to be numbered. If output was
  3105.           initiated from some offset from the end of the file, then the
  3106.           lines are numbered negatively from the known origin.
  3107.    
  3108.           This option works in /TEXT mode only.
  3109.    
  3110.         /[NO]Page - Page output (default is /NOPAGE)
  3111.           Pause after each full screenful. If multiple files are being
  3112.           output, then the "Press any key..." message also contains the
  3113.           filename of the current file.
  3114.    
  3115.         /[NO]SMart - Translate output (default is /NOSMART)
  3116.           This option causes data to be translated. It provides you with
  3117.           formatted display output.
  3118.    
  3119.           In /ASCII mode tabs are expanded, and Carriage-Return / Line-feeds
  3120.           are displayed as new lines.
  3121.    
  3122.    
  3123.    
  3124.    
  3125.    
  3126.    
  3127.    
  3128.                                       -47-    Obs Toolkit 1.5                                               FileDump
  3129.    
  3130.           In /TEXT mode, this option will convert files from UNIX and
  3131.           Macintosh so that they can be viewed correctly. You can redirect
  3132.           the output to convert the file into DOS format.
  3133.    
  3134.           In /HEX mode, this option will enable display of the extended
  3135.           ASCII characters.
  3136.    
  3137.           In /COUNT mode, this option has no effect.
  3138.    
  3139.           In /STRINGS mode, this option causes each string to be placed on a
  3140.           separate line and tabs to be expanded.
  3141.    
  3142.         /STrings # - Report contiguous strings
  3143.           Usage: FD /STRINGS count { WildSpec }
  3144.    
  3145.           This option causes only strings of ASCII printable characters
  3146.           which run as long as the specified length to be output.
  3147.    
  3148.           The /SMART option will separate different strings on different
  3149.           lines and expand tabs.
  3150.    
  3151.           The /COMPRESS option has no effect.
  3152.    
  3153.           The /BEGIN and /END offsets are in bytes.
  3154.    
  3155.         /TAb # - Set the tab setting every # spaces (default is 8)
  3156.           Usage: FD /TAB count { WildSpec }
  3157.    
  3158.           This option when combined with redirection, makes a great utility
  3159.           for removing tabs from files and replacing them with the
  3160.           appropriate number of spaces. The /TAB setting specifies the tab
  3161.           interval.
  3162.    
  3163.           Tip:
  3164.             Define a DETAB command that uses redirection to change tabs to
  3165.             spaces in a file
  3166.                ALIAS detab   FD /TEXT /TAB
  3167.    
  3168.         /TExt - Raw text output  (default)
  3169.           Output the text in raw mode. The yields results similar to the DOS
  3170.           type command.
  3171.    
  3172.           The /BINARY option will open the file in BINARY mode instead of
  3173.           TEXT mode. This is handy when catenating files together.
  3174.    
  3175.           The /BEGIN and /END offsets are in lines.
  3176.    
  3177.           The /COMPRESS option will compress multiple carriage return line
  3178.           feed pairs to a single new line.
  3179.    
  3180.           The /SMART option enables proper formatting for UNIX and Macintosh
  3181.           files.
  3182.    
  3183.    
  3184.    
  3185.    
  3186.    
  3187.                                       -48-    Obs Toolkit 1.5                                               FileDump
  3188.    
  3189.         /[NO]Wrap - Truncate lines (default is /WRAP)
  3190.           This option controls whether long lines are wrapped from the right
  3191.           hand side of the screen onto the next line.
  3192.    
  3193.           Note: The screen width is currently fixed at 80 characters.
  3194.    
  3195.        TIPS:
  3196.          Use Obs alias generator to define the following commands:
  3197.             ALIAS ascii   FD /ASCII /SMART /COMPRESS
  3198.             ALIAS cat     FD /TEXT /BINARY
  3199.             ALIAS count   FD /COUNT
  3200.             ALIAS dump    FD /HEX /COMPRESS
  3201.             ALIAS number  FD /NUMBER /NOWRAP
  3202.             ALIAS strings FD /STRINGS 4 /SMART
  3203.             ALIAS text    FD /TEXT
  3204.    
  3205.        Examples:
  3206.          C>FD file.txt
  3207.            Output FILE.TXT without any special formatting.
  3208.    
  3209.          C>FD /NUMBER file.txt
  3210.            Output FILE.TXT numbering lines.
  3211.    
  3212.          C>FD /NUMBER /NOWRAP file.txt
  3213.            Output FILE.TXT, numbering lines, but eliminate the annoying
  3214.            wrap.
  3215.    
  3216.          C>FD /NUMBER /NOWRAP /BEGIN -10 file.txt
  3217.            Output the last 10 lines of FILE.TXT and number the lines.
  3218.    
  3219.          C>FD /ASCII file.obj
  3220.            Output only the ASCII characters in FILE.OBJ. The other
  3221.            characters are identified with spaces.
  3222.    
  3223.          C>FD /ASCII /COMPRESS file.obj
  3224.            Output only the ASCII characters in FILE.OBJ and compress runs of
  3225.            non-ASCII characters to a single space.
  3226.    
  3227.          C>FD /ASCII /SMART /BEGIN 1000 /END 2000 file.txt
  3228.            Output only the ASCII characters in FILE.TXT, but interpret text
  3229.            alignment characters. Start at byte 1000 and end at byte 2000.
  3230.    
  3231.          C>FD /HEX /BEGIN -1000x /END +100x file.obj
  3232.            Dump FILE.OBJ in a HEX dump fashion. Start 1000 HEX bytes from
  3233.            the end of the file, and ends 100 HEX bytes later.
  3234.    
  3235.          C>FD /STRINGS 4 /SMART c:\command.com
  3236.            Search out strings of length 4 or greater in COMMAND.COM and
  3237.            display them one per line.
  3238.    
  3239.          C>FD /TEXT /BINARY a.fil b.fil c.fil > abc.fil
  3240.            This will glue files A, B, and C together in the order specified.
  3241.    
  3242.    
  3243.    
  3244.    
  3245.    
  3246.                                       -49-    Obs Toolkit 1.5                                               FileDump
  3247.    
  3248.          C>FD /TEXT /SMART unixfile > dosfile
  3249.            This will convert a file from the UNIX file format into the DOS
  3250.            file format.
  3251.    
  3252.          C>FD /TEXT /SMART macfile > dosfile
  3253.            This will convert a file from the Macintosh file format into the
  3254.            DOS file format.
  3255.    
  3256.    
  3257.    
  3258.    
  3259.    
  3260.    
  3261.    
  3262.    
  3263.    
  3264.    
  3265.    
  3266.    
  3267.    
  3268.    
  3269.    
  3270.    
  3271.    
  3272.    
  3273.    
  3274.    
  3275.    
  3276.    
  3277.    
  3278.    
  3279.    
  3280.    
  3281.    
  3282.    
  3283.    
  3284.    
  3285.    
  3286.    
  3287.    
  3288.    
  3289.    
  3290.    
  3291.    
  3292.    
  3293.    
  3294.    
  3295.    
  3296.    
  3297.    
  3298.    
  3299.    
  3300.    
  3301.    
  3302.    
  3303.    
  3304.    
  3305.                                       -50-    Obs Toolkit 1.5                                              ListFiles
  3306.    
  3307.                                 ListFiles (LF)
  3308.                                 --------------
  3309.    
  3310.      Description:
  3311.         Finding the files on your disk can be difficult. DOS's directory
  3312.         (DIR) can only show you the visible files and <DIR>s in a directory,
  3313.         and they're presented in no apparent order. We wanted more.
  3314.    
  3315.         Cleaning up a disk is a burdensome activity at best. Not being able
  3316.         to look into the file structure makes the job even harder. ListFiles
  3317.         can help.
  3318.    
  3319.         ListFiles allows you to list the files on your disk drive the way
  3320.         you want. Files can be listed by name, extension, size, time, or any
  3321.         combination thereof. Your output can be formatted into 1,2,3,4 or 5
  3322.         columns.
  3323.    
  3324.         In addition, ListFiles can look for and detect special conditions on
  3325.         your disk (e.g., duplicate files, old files, etc...).
  3326.    
  3327.      Usage:
  3328.         LF [options] [SmartPath][directory]{ WildSpec }
  3329.            Up to 16 include WildSpecs may be supplied.
  3330.    
  3331.            The options may appear anywhere on the command line.
  3332.    
  3333.            Only one drive:\path specification is permitted, and it may
  3334.            appear anywhere on the command line. This will root the operation
  3335.            to begin at that disk:\path. If the disk:\path are not supplied
  3336.            then ListFiles will default to the current drive and directory.
  3337.    
  3338.      Options:
  3339.         /1 - 12 hour time format (default)
  3340.    
  3341.         /2 - 24 hour time format
  3342.    
  3343.         /A - Attribute selection criteria
  3344.            Usage: LF /A[[:]{ [+|-|*]R|A|S|H|D }]
  3345.    
  3346.            This allows control over the selection of files based on a file's
  3347.            attributes. There are five (5) kinds of attributes that ListFiles
  3348.            recognizes;
  3349.    
  3350.            The attributes are maintained by DOS and are:
  3351.            (A) ARCHIVE; (S) SYSTEM; (R) READ-ONLY; (H) HIDDEN; (D) DIRECTORY
  3352.    
  3353.            Use of this option causes the file attributes to be displayed
  3354.            when using a lister.
  3355.    
  3356.          Option Qualifiers
  3357.            (when absent, defaults to /A+S+H (include SYSTEM and HIDDEN
  3358.            files))
  3359.    
  3360.    
  3361.    
  3362.    
  3363.    
  3364.                                       -51-    Obs Toolkit 1.5                                              ListFiles
  3365.    
  3366.            A - Archive
  3367.            D - Directory
  3368.            H - Hidden
  3369.            S - System
  3370.            R - Read-Only
  3371.    
  3372.          Option Sub-qualifiers (when absent, defaults to '*')
  3373.    
  3374.            * - File requires this attribute. Only files that possess this
  3375.                attribute are selected.
  3376.    
  3377.            + - Include files with this attribute (default). This is to
  3378.                collect System and Hidden files. This option qualifier has no
  3379.                affect on Archive and Read-Only attributes.
  3380.    
  3381.            - - File may not possess this attribute. Only files that DO NOT
  3382.                possess this attribute are selected.
  3383.    
  3384.            Note:
  3385.               Re-specifying an attribute will set that attribute to the
  3386.               current selection encountered. In other words
  3387.    
  3388.                 C>LF /A-A /A*A
  3389.    
  3390.               will report only the files that have the ARCHIVE attribute
  3391.               (the previous command to eliminate ARCHIVE files was
  3392.               superseded).
  3393.    
  3394.          Examples:
  3395.    
  3396.            /A     - All files, including SYSTEM and HIDDEN.
  3397.    
  3398.            /A+S+H - Include SYSTEM and HIDDEN files. This can be abbreviated
  3399.                     to just /A.
  3400.    
  3401.            /A*S*H - Only files that have both SYSTEM and HIDDEN attributes.
  3402.    
  3403.            /A-R   - Exclude files that are READ-ONLY.
  3404.    
  3405.            /A*A   - Select ARCHIVE files only.
  3406.    
  3407.            /A*D*H - Hidden directories only.
  3408.    
  3409.            /A-D   - Exclude directories.
  3410.    
  3411.          Note:
  3412.            Attribute displays are not explicitly enabled when attribute
  3413.            selections involve only directory restrictions.
  3414.    
  3415.            Selection attributes override previous selection attributes for
  3416.            the same attribute:
  3417.    
  3418.    
  3419.    
  3420.    
  3421.    
  3422.    
  3423.                                       -52-    Obs Toolkit 1.5                                              ListFiles
  3424.    
  3425.            Files with either of the special attributes System or Hidden are
  3426.            displayed in opposite case.
  3427.    
  3428.            Example:
  3429.               /A-D /A
  3430.                  This will include system and hidden files but exclude
  3431.                  directories. This is the same as (/A+S+H-D)
  3432.    
  3433.               /A-R-A /A*R
  3434.                  This is read-only files without the archive attribute. This
  3435.                  is the same as (/A-A*R).
  3436.    
  3437.         /B - Bare output
  3438.            Usage: LF /[-]B[+]
  3439.    
  3440.            This generates a command list output without any file information
  3441.            (other than the filename.ext), and without the header and trailer
  3442.            information. If you are recursing subdirectories, the disk and
  3443.            directory will be prepended to the filename.ext.
  3444.    
  3445.            If /B+ is selected the full pathnames will always be displayed.
  3446.    
  3447.         /C - Command generator
  3448.            Usage: LF /-C[B|T|E] | { /CB|/CT|/CE "meta-text" }
  3449.    
  3450.            This allows the generation of batch files to do some operation
  3451.            which Obs Toolkit does not directly support.
  3452.    
  3453.            This option provides a way to use the WildSpecs, attribute
  3454.            selection, and excludes with any application that accepts a
  3455.            filename as a parameter.
  3456.    
  3457.            To disable the active command configuration use /-C. To disable
  3458.            one of the options use /-Cx.
  3459.    
  3460.         Option Qualifiers: (no default, one must be selected)
  3461.            B - Begin output with text
  3462.            E - End output with text
  3463.            T - Output this text for each command
  3464.    
  3465.         Meta-text:
  3466.            Meta-characters are provided to generate additional commands. The
  3467.            meta-characters are the following:
  3468.    
  3469.              $E - Escape character
  3470.              $H - Backspace
  3471.              $_ - Carriage return and line feed
  3472.    
  3473.              $$ - $ (Dollar sign)
  3474.              $B - | (Bar, Pipe)
  3475.              $G - > (Greater-than sign, redirect output)
  3476.              $L - < (Less-than sign, redirect input)
  3477.    
  3478.    
  3479.    
  3480.    
  3481.    
  3482.                                       -53-    Obs Toolkit 1.5                                              ListFiles
  3483.    
  3484.              $D - Current date (at start of program)
  3485.              $T - Current time (at start of program)
  3486.    
  3487.              $P - Full pathname with backslash (drive:\path\)
  3488.              $F - Filename
  3489.              $X - Extension with dot (.ext)
  3490.    
  3491.            All other characters are passed through verbatim.
  3492.    
  3493.         Example:
  3494.            C>LF /CT "archive /add $F$X myarch.arc" /CEexit > arch_em.bat
  3495.    
  3496.              If the above two (2) options were invoked, ListFiles would
  3497.              create an output like the following (using all files in the
  3498.              current directory):
  3499.    
  3500.                 archive /add file1.ext myarch.arc
  3501.                 archive /add file2.ext myarch.arc
  3502.                   .
  3503.                   .
  3504.                 archive /add filen.ext myarch.arc
  3505.                 exit
  3506.    
  3507.              This output has been redirected (via DOS) into a batch file
  3508.              called ARCH_EM.BAT.
  3509.    
  3510.              ARCH_EM.BAT can now be executed by COMMAND.COM as a batch file
  3511.              by typing ARCH_EM at the command line.
  3512.    
  3513.            C>LF /CT "FD /SMART $F$X $G $F.cvt" *.mac *.unx > convert.bat
  3514.    
  3515.              This would generate a batch file that could be used to convert
  3516.              all the .DOS and .UNX files in the current directory into DOS
  3517.              files with names like filename.cvt. The batch file would look
  3518.              something like the following:
  3519.    
  3520.                 FD /SMART mac_1.mac > mac_1.cvt
  3521.                 FD /SMART mac_2.mac > mac_2.cvt
  3522.                   .
  3523.                   .
  3524.                 FD /SMART unix_n.unx > unix_n.cvt
  3525.    
  3526.         /D - Detect a special condition
  3527.            Usage: LF { /DC|/DD|/DO|/DH }
  3528.    
  3529.            This option peeks into the file structure and reports on the
  3530.            oddities that it was directed to detect.
  3531.    
  3532.            Option Qualifiers: (no default, one must be selected)
  3533.    
  3534.    
  3535.    
  3536.    
  3537.    
  3538.    
  3539.    
  3540.    
  3541.                                       -54-    Obs Toolkit 1.5                                              ListFiles
  3542.    
  3543.              C - duplicate Contents
  3544.                These are files that have the same exact contents. Sometimes
  3545.                they have the same name and sometimes they don't. The total
  3546.                file space reported allows for 1 copy. The total file count
  3547.                is one per set of duplicates.
  3548.    
  3549.              D - duplicate Directory entries
  3550.                These are files that have the same filename, extension, date,
  3551.                time, and size. The total file space reported allows for 1
  3552.                copy. The total file count is one per set of duplicates.
  3553.    
  3554.                The /Recurse option is technically required.
  3555.    
  3556.              H - Hidden programs
  3557.                These are the executable files that DOS won't find in a
  3558.                directory because of its search algorithm.
  3559.    
  3560.                Files in this class generally occur when you upgrade software
  3561.                without explicitly deleting the older version.
  3562.    
  3563.                Files of this type can cause some strange results when
  3564.                executable files cooperate in some fashion or another.
  3565.    
  3566.              O - Old files
  3567.                These are files that have the same filename and extension,
  3568.                yet for some reason or another have a different date and/or
  3569.                time.
  3570.    
  3571.                Sometimes the older files are ripe for elimination and
  3572.                sometimes they are a completely different file, but happen to
  3573.                have the same name; for example (DirSize, and someone else's
  3574.                Directory Sort).
  3575.    
  3576.                The /Recurse option is technically required.
  3577.    
  3578.         /G - Report only the grand total
  3579.            Usage: LF /[-]G
  3580.    
  3581.            This is good for generating a report or summary.
  3582.    
  3583.            When the details of which files are not important, but the fact
  3584.            that the condition exists is, then this option will shrink the
  3585.            output.
  3586.    
  3587.         /L - Use lower case
  3588.            Usage: LF /[-]L
  3589.    
  3590.            This option will cause filenames and directories to be displayed
  3591.            in lower case. You can use /-L to return to UPPER CASE.
  3592.    
  3593.         /O - File display order
  3594.            Usage: LF /-O | /O[[:]{ [-]D|E|G|N|R|S|U }]
  3595.    
  3596.    
  3597.    
  3598.    
  3599.    
  3600.                                       -55-    Obs Toolkit 1.5                                              ListFiles
  3601.    
  3602.            This option determines the ordering of the directory as it is
  3603.            displayed. LF /-O resets ListFiles so that there is no ordering.
  3604.    
  3605.            Each set of "significant" sort options (D,E,N,S,U) will replace
  3606.            the previous set (if any).
  3607.    
  3608.            Option Qualifiers:
  3609.    
  3610.              Prefix the qualifier with a '-' to reverse its meaning.
  3611.    
  3612.              The following option qualifiers are position dependent. The
  3613.              sort is ordered from the first to the last unless the '-' is
  3614.              present.
  3615.    
  3616.                D - by date/time
  3617.                E - by extension
  3618.                N - by name
  3619.                S - by size
  3620.                U - Unsorted (by directory)
  3621.    
  3622.              The next options are not positionally dependent, and effect the
  3623.              result of the overall sort operation.
  3624.    
  3625.                G - Group directories and files.
  3626.                    This option causes directories to be grouped at the top
  3627.                    (/Og) of the listing, or at the bottom (/O-g).
  3628.    
  3629.                R - Reverse output (global reverse).
  3630.                    This option causes the output to be reversed (/Or). To
  3631.                    place the output back into the correct order use (/O-r).
  3632.    
  3633.            TIP:
  3634.               You can use a stand alone /O to force a file listing along
  3635.               with the detectors.
  3636.    
  3637.            Examples:
  3638.              /One - Sort output by filename then extension
  3639.              /Oen - Sort output by extension then filename
  3640.              /Odr - Sort output by the newest file to the oldest
  3641.              /Os  - Sort output by the smallest file to the largest
  3642.              /-O  - Don't sort the output at all
  3643.    
  3644.         /P - Page the output
  3645.            Usage: LF /[-]P
  3646.    
  3647.            This option waits for the user to press a key after each full
  3648.            screenful. It is 25/43/50 line aware.
  3649.    
  3650.         /R - Recurse sub-directories
  3651.            Usage: LF /[-]R
  3652.    
  3653.            This option indicates that all sub-directories, subordinate to
  3654.            the base specified (or implied), shall also be searched for
  3655.            files.
  3656.    
  3657.    
  3658.    
  3659.                                       -56-    Obs Toolkit 1.5                                              ListFiles
  3660.    
  3661.         /S - Size restriction
  3662.            Usage: LF { /SL|/SE|/SG size }
  3663.    
  3664.            This restriction excludes files that don't meet the size
  3665.            requirement.
  3666.    
  3667.            Size requirements can select files which are equal to the
  3668.            specified size, greater than, less than, or somewhere between a
  3669.            maximum and a minimum size.
  3670.    
  3671.            Option Qualifiers:
  3672.              E - Equal to
  3673.              G - Greater than
  3674.              L - Less than
  3675.    
  3676.            Example:
  3677.              /SE     0 - files without any contents 0K
  3678.              /SG 65536 - files greater than 64K bytes
  3679.              /SL   100 - files less than 100 bytes (disk eaters)
  3680.    
  3681.         /T - Time restriction
  3682.            Usage: LF { /TB|/TE|/TS "date time" }
  3683.    
  3684.            This restriction excludes files that don't make the date/time
  3685.            requirement.
  3686.    
  3687.            Time requirements can select files which are equal to the
  3688.            specified Date/Time (exact), written sooner than (before),
  3689.            written after (since), or somewhere between two times.
  3690.    
  3691.            Option Qualifiers:
  3692.              B - Before
  3693.              E - Exact
  3694.              S - Since
  3695.    
  3696.            Option sub-qualifiers:
  3697.              "date time" - a date/time pair must be quoted
  3698.    
  3699.            Examples:
  3700.              /TB 1-1-90  - list all files written before 1990
  3701.                            (Before 1/1/90)
  3702.    
  3703.              /TS-0       - list all files written today and beyond
  3704.                            (Since zero (0) days ago)
  3705.    
  3706.              /TE-1       - list all files written yesterday
  3707.                            (Equal to one (1) day ago)
  3708.    
  3709.         /W - Wide output
  3710.            Usage: LF /[-]W[columns]
  3711.                   columns can be 1,2,3,4 or 5
  3712.    
  3713.    
  3714.    
  3715.    
  3716.    
  3717.    
  3718.                                       -57-    Obs Toolkit 1.5                                              ListFiles
  3719.    
  3720.            This options causes the filenames to be output in the requested
  3721.            number of columns. The normal number of columns is 1. When
  3722.            columns is not specified the number of columns is 5.
  3723.    
  3724.            One column output can display everything about a file.
  3725.    
  3726.            Two column output can display everything but the files
  3727.            attributes.
  3728.    
  3729.            Three column output displays the filename and size where the size
  3730.            is grouped with commas.
  3731.    
  3732.            Four colum output displays the filename and size where the size
  3733.            is displayed in kilobytes 'K'.
  3734.    
  3735.            Five column output displays the filenames where directories are
  3736.            identified with square brackets [].
  3737.    
  3738.         /X - Exclude WildSpec
  3739.            Usage: LF /-X | { /X WildSpec }
  3740.    
  3741.            This option allows you to exclude files. Up to 16 exclude
  3742.            WildSpecs may be supplied.
  3743.    
  3744.            Use /-X to clear the exclude list.
  3745.    
  3746.      TIPS:
  3747.         C>ALIAS dir LF
  3748.           List files in alphabetical order.
  3749.    
  3750.         C>ALIAS bytime LF /ODNE
  3751.           List files from the oldest to the newest.
  3752.    
  3753.         C>ALIAS bysize LF /OSNE
  3754.           List files from the smallest to the largest.
  3755.    
  3756.         C>ALIAS byext  LF /OUNE
  3757.           List files grouped by extension. This may seem a little odd to use
  3758.           the unsorted option. The unsorted option causes the directories to
  3759.           be displayed in order when you recurse through them.
  3760.    
  3761.         C>ALIAS progs  LF *.exe *.com *.bat
  3762.           List only the executable files.
  3763.    
  3764.         C>ALIAS docs LF *.doc *.txt read*.*
  3765.           List only the (likely) documentation files.
  3766.    
  3767.         C>ALIAS code LF *.c *.cpp *.h *.inc *.pas *.asm
  3768.           List only the source code files.
  3769.    
  3770.         C>ALIAS dirs   LF /AD
  3771.           List only the directories and exclude the files.
  3772.    
  3773.    
  3774.    
  3775.    
  3776.    
  3777.                                       -58-    Obs Toolkit 1.5                                              ListFiles
  3778.    
  3779.         C>ALIAS files  LF /A-D
  3780.           List only the files and exclude the directories.
  3781.    
  3782.         You could use the alias generator to create a find file command.
  3783.           C>ALIAS ff LF /R \
  3784.    
  3785.           You could then customize the output of this find file (e.g., sort
  3786.           by time, or size).
  3787.    
  3788.           Even though it isn't ListFiles intended purpose, it was faster
  3789.           than most of the Find File utilities it was benched against.
  3790.    
  3791.           LOCATE /FILE is just a smidgit slower, but can search across
  3792.           multiple drives.
  3793.    
  3794.      Examples:
  3795.         C>LF
  3796.           List all normal files in the current directory. Files will be
  3797.           sorted by name and extension.
  3798.    
  3799.         C>LF *.exe *.com *.bat \util
  3800.           List all the DOS executable files in the UTIL directory on the
  3801.           current drive.
  3802.    
  3803.           Files will be sorted by name, and extension.
  3804.    
  3805.         C>LF /R /A /P
  3806.           List all files (including Hidden and System) in the current and
  3807.           subordinate directories.
  3808.    
  3809.           Files will be sorted by directory, name, and extension.
  3810.    
  3811.           File attributes will be displayed.
  3812.    
  3813.           Page the output for convenient viewing.
  3814.    
  3815.         C>LF /OSNER /R C:\
  3816.           List all files in all directories, starting at the root directory
  3817.           on drive C:.
  3818.    
  3819.           Files will be sorted by size, name, extension. The output is
  3820.           reversed; files are from the largest to the smallest.
  3821.    
  3822.         C>LF /TE-0 /R D:\
  3823.           List all files on the D: drive which were written today.
  3824.    
  3825.           Files will be sorted by time, with the oldest file at the top, and
  3826.           the most recent file at the bottom.
  3827.    
  3828.         C>LF /DD /R \*.bak
  3829.           List all .BAK files with duplicate directory entries, starting at
  3830.           the root directory on the current drive.
  3831.    
  3832.    
  3833.    
  3834.    
  3835.    
  3836.                                       -59-    Obs Toolkit 1.5                                              ListFiles
  3837.    
  3838.         C>LF /DC /R \*.bak
  3839.           List all .BAK files with duplicate contents, starting at the root
  3840.           directory on the current drive.
  3841.    
  3842.         C>LF /SG 1048756 /OR /R \
  3843.           List all files on the current drive that are larger than 1Mb.
  3844.    
  3845.           Reverse the sort such that the largest files will appear at the
  3846.           top of the list.
  3847.    
  3848.         C>LF /X *.c /X *.obj /X *.exe \cprogs
  3849.           List all files in the "CPROGS" directory on the current drive that
  3850.           are not .C, .OBJ, or .EXE files.
  3851.    
  3852.         C>LF /DD /DC /DH /DO /R \
  3853.           List all files with duplicate directory entries, with duplicate
  3854.           contents, that are hidden from DOS execution, or have the same
  3855.           filename.ext yet have different date and times.
  3856.    
  3857.           This generates a report where each option is executed
  3858.           sequentially.
  3859.    
  3860.           The reports are not intersected.
  3861.    
  3862.         C>LF /TS. /R \
  3863.           List all the files on the current drive that were written after
  3864.           the current time. This isn't as unusual as it seems, some vendors
  3865.           place some odd time stamps on their files.
  3866.    
  3867.      Notes:
  3868.         The /Detect options may be combined with each other, and with the
  3869.         lister (/O) without affecting each other's operation. The results of
  3870.         the program will be output sequentially.
  3871.    
  3872.         Only one Lister (/O) may be selected at a time.
  3873.    
  3874.         The /X (exclude), /Recurse, /Size, /Attribute & /Time effect the
  3875.         file selection criteria, and apply to the /Detectors, and the
  3876.         Lister (/O).
  3877.    
  3878.         Files with attributes Hidden or System are always displayed in
  3879.         opposite case.
  3880.    
  3881.      DOS operational differences:
  3882.         /Size is used to specify size restrictions (DOS uses /S to search
  3883.         sub-directories). ListFiles can recurse subdirectories using the
  3884.         /Recurse option.
  3885.    
  3886.    
  3887.    
  3888.    
  3889.    
  3890.    
  3891.    
  3892.    
  3893.    
  3894.    
  3895.                                       -60-    Obs Toolkit 1.5                                                 Locate
  3896.    
  3897.                                 Locate (LOCATE)
  3898.                                 ---------------
  3899.    
  3900.      Description:
  3901.         This utility finds out which file DOS will execute when you type is
  3902.         name on the command line; and doubles as a multi-disk file find
  3903.         utility.
  3904.    
  3905.         When looking for a command, the aliased commands, and internal
  3906.         command tables are consulted, and the PATH variable is searched to
  3907.         find the executable files. The first match (which is the command
  3908.         that would be executed) is displayed.
  3909.    
  3910.         This utility is fully Obs alias aware, and will translate Obs
  3911.         aliases as required to locate the command.
  3912.    
  3913.         When searching for files, this command will search the disks in the
  3914.         order specified (left to right), but will search each drive only
  3915.         once.
  3916.    
  3917.         TIP:
  3918.            When your system doesn't do what you expect or you're not sure if
  3919.            someone wrapped a batch file around the command or you want a
  3920.            real fast file find for a particular command, then LOCATE it.
  3921.    
  3922.      Usage:
  3923.         LOCATE /COMMAND  [options] [WildSpec]
  3924.         LOCATE /FILE     [options] [{ drives }] [WildSpec]
  3925.    
  3926.         {drives} can be any number of drives A: B: C: etc... The drives will
  3927.         be searched in the order specified, but each drive only once.
  3928.    
  3929.         If no drive is supplied, then the current drive will be used.
  3930.    
  3931.      Options:
  3932.         /[NO]All - All files
  3933.            This option includes system and hidden files. This option is
  3934.            valid with /FILE only.
  3935.    
  3936.         /[NO]CHange - Change to the directory where the command is found
  3937.            This option, valid during /COMMAND only, will cause the current
  3938.            directory to be changed to the directory where the command was
  3939.            found.
  3940.    
  3941.            Use of this option suppresses the normal /COMMAND information and
  3942.            operates quietly.
  3943.    
  3944.         /COmmand (Cmd) - Find command (default)
  3945.            This option locates the specified command in the list of all
  3946.            executable commands. If the WildSpec indicates a single command,
  3947.            then the launch time is calculated and displayed.
  3948.    
  3949.            Obs aliased commands are resolved.
  3950.    
  3951.    
  3952.    
  3953.    
  3954.                                       -61-    Obs Toolkit 1.5                                                 Locate
  3955.    
  3956.            TIPS:
  3957.               Use LOCATE /Command to tune your path for frequently used
  3958.               commands. Use EE /EDIT to edit the PATH during tuning.
  3959.    
  3960.               LOCATE /Command will show that for those frequently used
  3961.               commands, "LF" for example, it is best to alias them directly
  3962.               to the executable file. This will significantly reduce the
  3963.               access time to command.
  3964.    
  3965.               Example:
  3966.                  C>ALIAS dir f:\util\lf.exe
  3967.    
  3968.         /FIle - File search
  3969.            This is a basic file find with enhanced wildcards. Multiple
  3970.            drives can be searched by specifying them on the command line:
  3971.    
  3972.            Example:
  3973.               C>LOCATE /FILE c: e: locate.exe
  3974.                  This instructs LOCATE to attempt to locate the file
  3975.                  "locate.exe" on the C: and E: drives.
  3976.    
  3977.         /[NO]FUll - Display full file information for external commands
  3978.            Report the file date, time, and size for the external command.
  3979.    
  3980.         /[NO]Page - Page output
  3981.            This option instructs locate to pause when the screen is full.
  3982.    
  3983.         /[NO]Wide - Wide output
  3984.            This outputs multiple Filenames/Commands on each line.
  3985.    
  3986.      Note:
  3987.         Locate tries to be smart about whether you are looking for a command
  3988.         or a file. If there is a '.' in the argument or there is a drive
  3989.         specified, then locate will default to /FILE, otherwise it will
  3990.         default to /CMD. You may override the default by specifying /FILE or
  3991.         /COMMAND as desired.
  3992.    
  3993.         Locate /COMMAND observes the current case setting and alias
  3994.         abbreviations when attempting to resolve aliases.
  3995.    
  3996.      TIP:
  3997.         Define a file find command:
  3998.           C>ALIAS ff LOCATE /FILE c: e:
  3999.             FF will search the C and E drives for the requested file.
  4000.    
  4001.      Examples:
  4002.         C>LOCATE /COMMAND ds
  4003.           Reports which DS would be executed if C>DS were issued as a
  4004.           command.
  4005.    
  4006.         C>LOCATE /FILE read.me
  4007.           Reports all the READ.ME files on the current drive.
  4008.    
  4009.    
  4010.    
  4011.    
  4012.    
  4013.                                       -62-    Obs Toolkit 1.5                                                 Locate
  4014.    
  4015.         C>LOCATE dir
  4016.           Reports what DIR would translate to if C>DIR were issued, and
  4017.           times the path search to the command.
  4018.    
  4019.         C>LOCATE c: file
  4020.           This will default to LOCATE /FILE c: file. Search for FILE.* on
  4021.           the C: drive.
  4022.    
  4023.         C>LOCATE file.exe
  4024.           This will default to LOCATE /FILE file.exe. Search for FILE.* on
  4025.           the default drive.
  4026.    
  4027.         C>LOCATE /CMD *.
  4028.           This will display all the internal commands on your machine.
  4029.    
  4030.         C>LOCATE /CMD *.exe
  4031.           This will display all the commands in the current path that are
  4032.           supported via EXE files.
  4033.    
  4034.         C>LOCATE /FULL xcopy
  4035.           This will locate the command for XCOPY and display its file date,
  4036.           time and size.
  4037.    
  4038.         C>LOCATE /CHANGE autoexec
  4039.           This will locate the command for AUTOEXEC and change into the
  4040.           directory where the AUTOEXEC is found.
  4041.    
  4042.    
  4043.    
  4044.    
  4045.    
  4046.    
  4047.    
  4048.    
  4049.    
  4050.    
  4051.    
  4052.    
  4053.    
  4054.    
  4055.    
  4056.    
  4057.    
  4058.    
  4059.    
  4060.    
  4061.    
  4062.    
  4063.    
  4064.    
  4065.    
  4066.    
  4067.    
  4068.    
  4069.    
  4070.    
  4071.    
  4072.                                       -63-    Obs Toolkit 1.5                                              MultiFile
  4073.    
  4074.                                 MultiFile (MF)
  4075.                                 --------------
  4076.    
  4077.      Description:
  4078.         Now that you found all those files that you want to manipulate, you
  4079.         need a tool to do the job easily and efficiently. That's where
  4080.         MultiFile comes in.
  4081.    
  4082.         MultiFile is the file manipulator. MultiFile can copy, delete and
  4083.         move directories and files with the same restrictive capabilities as
  4084.         ListFiles (sans size).
  4085.    
  4086.         MultiFile is cautious because it warns you if you are going to
  4087.         delete any data; yet it's understanding because you can force
  4088.         operations and eliminate the warnings.
  4089.    
  4090.         MultiFile is safer than COMMAND.COM; MultiFile will not destroy an
  4091.         existing target file if there isn't enough room on disk for its
  4092.         replacement.
  4093.    
  4094.      TIPS:
  4095.         Define the following commands:
  4096.            C>ALIAS copy  MF /C
  4097.            C>ALIAS del   MF /D
  4098.            C>ALIAS ren   MF /M
  4099.    
  4100.         These will work just as you expect but will have expanded WildCard
  4101.         capabilities, more selection criteria, prompting support, forced
  4102.         operations, warnings, smarter copying, and more.
  4103.    
  4104.         Define a command to remove an entire directory branch:
  4105.            C>ALIAS prune MF /D /R
  4106.    
  4107.         CAUTION:
  4108.            The PRUNE command as described above will remove the specified
  4109.            directory even if there are files or sub-directories within it.
  4110.            This command is very powerful and must be used with caution.
  4111.    
  4112.         When you have one of those files with odd characters (like spaces)
  4113.         in the filename then quote the filename. When the filename is
  4114.         quoted, MultiFile will treat it just the way you type it. You can
  4115.         use ALT-<numpad> to enter really weird characters; however, some
  4116.         DOS-Editors disable this capability.
  4117.    
  4118.         Example:
  4119.            C>MF /D /A "ea data. sf"
  4120.               This will delete that file, even with the spaces in the name.
  4121.               You may have this file on your disk, so don't play with this
  4122.               command.
  4123.    
  4124.      Usage:
  4125.         MF [options] [SmartPath]WildSpec [SmartPath][WildSpec]
  4126.    
  4127.    
  4128.    
  4129.    
  4130.    
  4131.                                       -64-    Obs Toolkit 1.5                                              MultiFile
  4132.    
  4133.      Options:
  4134.         /! - Test drive
  4135.            Usage: MF /[-]!
  4136.    
  4137.            This option causes MultiFile to report its actions without
  4138.            actually performing them.
  4139.    
  4140.            This option allows you to verify MultiFiles actions.
  4141.    
  4142.         /A - Attribute selection criteria
  4143.            Usage: MF /A[[:]{ [+|-|*] R|A|S|H }]
  4144.    
  4145.            This allows control over the selection of files based on a file's
  4146.            attributes. There are four (4) kinds of attributes that MultiFile
  4147.            recognizes;
  4148.    
  4149.            The attributes are maintained by DOS and are:
  4150.            (A) ARCHIVE; (S) SYSTEM; (R) READ-ONLY; (H) HIDDEN
  4151.    
  4152.            MultiFile does not support the usage of the DIRECTORY attribute.
  4153.    
  4154.          Option Qualifiers (when absent, defaults to /A+S+H include SYSTEM
  4155.                             and HIDDEN files)
  4156.            A - Archive
  4157.            S - System
  4158.            R - Read-Only
  4159.            H - Hidden
  4160.    
  4161.          Option Sub-qualifiers (when absent, defaults to '*')
  4162.    
  4163.            * - File requires this attribute. Only files that possess the
  4164.                specified attribute are selected.
  4165.    
  4166.            + - Include files with this attribute (default). This is to
  4167.                collect System and Hidden files. This option qualifier has no
  4168.                effect on Archive and Read-Only attributes.
  4169.    
  4170.            - - File may not possess this attribute. Only files that DO NOT
  4171.                possess the specified attribute are selected.
  4172.    
  4173.          Example:
  4174.            /A     - All files, including SYSTEM and HIDDEN.
  4175.    
  4176.            /A+s+h - Include SYSTEM and HIDDEN files. This is the default and
  4177.                     can be abbreviated to just /A.
  4178.    
  4179.            /Ash   - Only files that have both SYSTEM and HIDDEN attributes.
  4180.    
  4181.            /A-r   - Exclude files that are READ-ONLY.
  4182.    
  4183.            /A*a   - Select ARCHIVE files only.
  4184.    
  4185.    
  4186.    
  4187.    
  4188.    
  4189.    
  4190.                                       -65-    Obs Toolkit 1.5                                              MultiFile
  4191.    
  4192.         /C - Copy files
  4193.            This option directs MultiFile to perform a copy operation. The
  4194.            source can be a filename, a directory name, or a WildSpec.
  4195.    
  4196.            Default operation for copy is to Add/Replace files, but to warn
  4197.            about impending overwrite conditions.
  4198.    
  4199.            If a WildSpec is selected for the destination, then the files
  4200.            will be renamed during the copy.
  4201.    
  4202.            Option Qualifiers:
  4203.              Usage: MF /C{ U|R|A } WildSpec [WildSpec]
  4204.    
  4205.              When no option qualifiers are selected, the default action is
  4206.              to copy all selected files.
  4207.    
  4208.              When the target WildSpec is omitted, the source files will be
  4209.              copied into the current directory.
  4210.    
  4211.              U - UPDATE files
  4212.                Copy the files that exist in the target directory, but have a
  4213.                more recent time stamp in the source directory.
  4214.    
  4215.                Note: Be sure that your clock keeps correct time.
  4216.    
  4217.              R - REPLACE existing files
  4218.                These are files that exist in the target directory and the
  4219.                source directory. This option causes MultiFile to replace
  4220.                every file in the target with the file from the source.
  4221.    
  4222.              A - ADD new files
  4223.                Add to the target directory, the files that exist in the
  4224.                source, but are not in the target.
  4225.    
  4226.                This command goes well with /CopyUpdate. Together, they
  4227.                update a target directory to the same contents as the source.
  4228.    
  4229.                NOTE:
  4230.                  The target will retain existing files that are no longer
  4231.                  present in the source directory.
  4232.    
  4233.              TIP:
  4234.                To get COPY to work somewhat like DOS, define it to be:
  4235.                  C>ALIAS copy MF /CAR
  4236.    
  4237.              Note:
  4238.                Each set of COPY options completely replaces the previous
  4239.                copy selection on the line. In other words, only the last
  4240.                selection is used.
  4241.    
  4242.                  MF /CU /CA /CAR /CR /CA source target
  4243.    
  4244.                this will only add files to the target directory.
  4245.    
  4246.    
  4247.    
  4248.    
  4249.                                       -66-    Obs Toolkit 1.5                                              MultiFile
  4250.    
  4251.         /D - Delete files
  4252.            Usage: MF /D WildSpec
  4253.    
  4254.            This option directs MultiFile to delete a file, a group of files,
  4255.            or even a directory (empty or not). Delete commands require
  4256.            confirmation unless the Force option is selected.
  4257.    
  4258.            TIP:
  4259.              Use MultiFile's PROMPT option to selectively confirm the delete
  4260.              operation for each file.
  4261.    
  4262.            Examples:
  4263.    
  4264.               C>MF /D filename.ext
  4265.                 This would delete FILENAME.EXT in the current directory.
  4266.    
  4267.               C>MF /D /R \*.bak
  4268.                 This would delete all .BAK files in all directories on the
  4269.                 default disk.
  4270.    
  4271.                 This option comes with a confirmation warning.
  4272.    
  4273.               C>MF /D /R dirname
  4274.                 This would delete all files, sub-directories, and eventually
  4275.                 the directory itself.
  4276.    
  4277.                 This option comes with a confirmation warning.
  4278.    
  4279.         /H - Hoist files to the target directory (flatten tree)
  4280.            Usage: MF /[-]H
  4281.    
  4282.            Normally MultiFile will preserve the tree structure to the target
  4283.            whenever it does a recursive copy or move operation.
  4284.    
  4285.            Sometimes it may be desired to collect files in a tree into a
  4286.            single directory, or it may be necessary to flatten a tree. This
  4287.            option instructs MultiFile to do just that.
  4288.    
  4289.            Note:
  4290.               When a tree is flattened to a single directory, and there are
  4291.               two files with identical names in the tree, MultiFile will
  4292.               only bring the most recent file to the target.
  4293.    
  4294.         /I - Ignore overwrites by skipping file
  4295.            Usage: MF /[-]I
  4296.    
  4297.            This option instructs MultiFile to skip files which would
  4298.            overwrite themselves. When MultiFile is copying or moving files,
  4299.            and the target is the source, MultiFile will skip the file
  4300.            without notification.
  4301.    
  4302.         /F - Force operations
  4303.            Usage: MF /[-]F
  4304.    
  4305.    
  4306.    
  4307.    
  4308.                                       -67-    Obs Toolkit 1.5                                              MultiFile
  4309.    
  4310.            MultiFile tries to warn you before a file is overwritten, or a
  4311.            read-only file is deleted. The Force option eliminates the
  4312.            warning message and proceeds as if the warning was issued and
  4313.            you gave MultiFile a YES.
  4314.    
  4315.            The specific operation of the Force option is:
  4316.    
  4317.            COPY:   Files (existing and Read-Only) are overwritten without
  4318.                    warning.
  4319.                    Directory is created without warning.
  4320.    
  4321.            DELETE:
  4322.              FILE: Files are deleted without warning.
  4323.                    Forces deletion of read-only files.
  4324.              DIR:  Directory is deleted without warning.
  4325.    
  4326.            MOVE:   Files (existing and Read-Only) are overwritten without
  4327.                    warning.
  4328.                    Directory is created without warning.
  4329.    
  4330.            When copying, deleting, or moving files, Force stops the message
  4331.            that says the file is Read-Only.
  4332.    
  4333.            CAUTION:
  4334.               Use of the Force option is just like answering YES to all
  4335.               cautions and warnings.
  4336.    
  4337.         /N - Copy only new files
  4338.            Usage: MF /[-]N
  4339.    
  4340.            This option is permitted during a copy operation (/Cx) only. This
  4341.            option can be combined with any of the copy operations (Update
  4342.            (/CU), Replace (/CR), etc...).
  4343.    
  4344.            Only files with the ARCHIVE attribute will be selected.
  4345.    
  4346.            The ARCHIVE attribute will be cleared on each source file after
  4347.            it has been successfully copied.
  4348.    
  4349.         /M - Move (rename) files
  4350.            Usage: MF /M WildSpec [WildSpec]
  4351.    
  4352.            This option directs MultiFile to Move a file, a directory, or a
  4353.            group of files to a new destination. If the target is on the same
  4354.            drive, then an optimum rename strategy is applied. If the target
  4355.            is a different drive, then the files are copied, and deleted.
  4356.    
  4357.            If the target WildSpec is omitted, then the source files will be
  4358.            moved to the current directory.
  4359.    
  4360.            To rename a file into a directory, then append a backslash to the
  4361.            end of the target directory name.
  4362.    
  4363.               MF /M filename.exe d:\dirname\
  4364.    
  4365.    
  4366.    
  4367.                                       -68-    Obs Toolkit 1.5                                              MultiFile
  4368.    
  4369.         /P - Prompt at each file
  4370.            Usage: MF /[-]P
  4371.    
  4372.            When the Prompt option is invoked, MultiFile will seek
  4373.            confirmation for its operation for each file. This provides the
  4374.            finest resolution of file selection available.
  4375.    
  4376.            This option causes each filename to be presented to the user for
  4377.            confirmation.
  4378.    
  4379.            This option is inhibited for individual files.
  4380.    
  4381.            The applicable responses to a Prompt are (Y/N/A/Q):
  4382.    
  4383.              (Y)es  - YES, perform operation on the indicated file.
  4384.              (N)o   -  NO, skip this file.
  4385.              (A)ll  - YES, perform operation on this and all remaining
  4386.                            files. Unless Force is enabled, you will be
  4387.                            prompted for confirmation.
  4388.              (Q)uit - NO,  skip this and all remaining files.
  4389.    
  4390.            This option will suppress redundant warning messages by combining
  4391.            them in the Prompt.
  4392.    
  4393.            When Prompting, the files are presented to you in alphabetical
  4394.            order.
  4395.    
  4396.         /Q - Quiet operation
  4397.            Usage: MF /[-]Q
  4398.    
  4399.            This option shuts off the in-progress messages that scroll up the
  4400.            screen (the filenames already acted upon).
  4401.    
  4402.         /R - Recurse subdirectories
  4403.            Usage: MF /[-]R
  4404.    
  4405.            This option indicates that all sub-directories, subordinate to
  4406.            the base specified (or implied), shall also be searched for
  4407.            files.
  4408.    
  4409.         /S - Set file characteristics
  4410.            Usage: MF /SA{ [+|-]R|A|S|H } WildSpec |
  4411.                   MF /ST"date time" WildSpec
  4412.    
  4413.            This option directs MultiFile to alter the directory entry of the
  4414.            specified files. The Set command can change file attributes
  4415.            and/or the date and time stamp of the file.
  4416.    
  4417.    
  4418.    
  4419.    
  4420.    
  4421.    
  4422.    
  4423.    
  4424.    
  4425.    
  4426.                                       -69-    Obs Toolkit 1.5                                              MultiFile
  4427.    
  4428.            Option Qualifiers
  4429.               A - Set file ATTRIBUTES
  4430.                 A - Archive
  4431.                 H - Hidden
  4432.                 R - Read-Only
  4433.                 S - System
  4434.    
  4435.               Note:
  4436.                 If an attribute is not specified it will not be altered.
  4437.    
  4438.               Option sub-qualifiers:
  4439.                 + - Add attribute (default)
  4440.                 - - Remove attribute
  4441.    
  4442.               T - set file TIME and Date
  4443.                 "date time" - date & time to set files to.
  4444.    
  4445.            Examples:
  4446.               C>MF /SA+R c:\autoexec.bat
  4447.                 Set the read-only attribute on the file AUTOEXEC.BAT in the
  4448.                 root directory of the C: drive.
  4449.    
  4450.               C>MF /ST "1-10-92 1:50" \obskit\*.*
  4451.                 Set the date and time of all files in the OBSKIT directory
  4452.                 to be January 10, 1992, and mark the version to 1.5. Many
  4453.                 developers embed the version in the files time stamp.
  4454.    
  4455.         /T - Time restrictions
  4456.            Usage: MF { /TB|/TE|/TS "date time" }
  4457.    
  4458.            This restriction excludes files which don't make the date/time
  4459.            requirement.
  4460.    
  4461.            Time requirements can select files which are equal to the
  4462.            specified Date/Time (exact), written sooner than (before),
  4463.            written after (since), or somewhere between two times.
  4464.    
  4465.            Option Qualifiers:
  4466.              B - Before
  4467.              E - Exact
  4468.              S - Since
  4469.    
  4470.            Option sub-qualifiers:
  4471.              "date time" - a date/time pair must be quoted
  4472.    
  4473.            Example:
  4474.              /TB 1-1-90  - all the files written before 1990
  4475.              /TS-0       - all the files written today
  4476.              /TE "-1 ."  - all the files written in the last 24 hours.
  4477.    
  4478.            MultiFile will warn you if no files are excluded.
  4479.    
  4480.    
  4481.    
  4482.    
  4483.    
  4484.    
  4485.                                       -70-    Obs Toolkit 1.5                                              MultiFile
  4486.    
  4487.         /V - Verify writes
  4488.            Usage: MF /[-]V
  4489.    
  4490.            This option directs MultiFile to set the DOS verify flag. The
  4491.            flag is reset to the default when the write operations are
  4492.            complete.
  4493.    
  4494.         /X - Exclude WildSpec
  4495.            Usage: MF /-X | { /X WildSpec }
  4496.    
  4497.            This option allows you to exclude files. Up to 16 exclude
  4498.            WildSpecs may be supplied. You can clear the list of excludes by
  4499.            issuing /-X.
  4500.    
  4501.            MultiFile will warn you if no files are excluded.
  4502.    
  4503.         /Y - Yes to cautions
  4504.            Usage: MF /[-]Y
  4505.    
  4506.            This option answers yes to the caution prompts. The option is not
  4507.            as inclusive as Force.
  4508.    
  4509.            The specific operation of Yes is to:
  4510.    
  4511.              COPY:
  4512.                 Confirm creation of a directory if necessary
  4513.                 Confirm file overwrite (not for READ-ONLY files)
  4514.    
  4515.              MOVE:
  4516.                 Confirm creation of a directory if necessary
  4517.                 Confirm file overwrite (not for READ-ONLY files)
  4518.    
  4519.              DELETE:
  4520.                 No operation.
  4521.    
  4522.              MODIFY:
  4523.                 No operation.
  4524.    
  4525.      TIPS:
  4526.        Define an UPDATE command to replace the contents of the target
  4527.        directory, with the newer files in the source directory.
  4528.          C>ALIAS update MF /CU .
  4529.    
  4530.        Define a copy that doesn't perform any unnecessary work
  4531.          C>ALIAS qcopy MF /CUA
  4532.    
  4533.          This QCOPY will only update files in, and add files to the target
  4534.          directory. This is what you normally want to happen anyway.
  4535.    
  4536.        Define a TOUCH command to update files to the current date and time.
  4537.          C>ALIAS touch MF /ST.
  4538.    
  4539.    
  4540.    
  4541.    
  4542.    
  4543.    
  4544.                                       -71-    Obs Toolkit 1.5                                              MultiFile
  4545.    
  4546.      Examples:
  4547.         C>MF /D *89.bck
  4548.           Delete all the .BCK files in the current directory that end in 89.
  4549.    
  4550.         C>MF /C /X*.bak /X*.obj /X*.tmp . f:\backup
  4551.           Create a BACKUP directory on the F: drive, and place into it, all
  4552.           the files in the current directory that aren't .BAK, .OBJ, or
  4553.           .TMP.
  4554.    
  4555.         C>MF /CU . f:\backup
  4556.           Update the F:\BACKUP directory with the files of later timestamp
  4557.           in the current directory.
  4558.    
  4559.         C>MF /CUA . f:\backup
  4560.           Update the F:\BACKUP directory with the updated and new files in
  4561.           the current directory. (Note if you are following the above
  4562.           examples, then this command would add to the F:\BACKUP directory
  4563.           all the .BAK, .OBJ, and .TMP files that were excluded earlier).
  4564.    
  4565.         C>MF /C /H /TE-0 /R \ a:\
  4566.           Copy all the files on the current drive, that were written today,
  4567.           onto the A: drive. Flatten the tree into a single directory.
  4568.    
  4569.         C>MF /D f:\backup\*.bak
  4570.           Delete the .BAK files in the F:\BACKUP directory.
  4571.    
  4572.         C>MF /D /R dirname
  4573.           Remove the directory DIRNAME and delete all of its' contents. This
  4574.           command will require confirmation.
  4575.    
  4576.         C>MF /D /R c:\*.bak
  4577.           Delete all .BAK files on the C: drive. This command will require
  4578.           confirmation.
  4579.    
  4580.         C>MF /D /R /F c:\*.bak
  4581.           Delete all .BAK files on the C: drive, but do not ask for
  4582.           confirmation before proceeding with the operation.
  4583.    
  4584.         C>MF /D /R /P c:\*.bak
  4585.           Delete all .BAK files on the C: drive, but ask the user before
  4586.           each file as to whether the file should be deleted or not.
  4587.    
  4588.         C>MF /M /R . a:\
  4589.           Move the current directory (Tree intact) to the A: drive.
  4590.    
  4591.           Note:
  4592.             Currently the files must fit on the target drive or an error
  4593.             indicating Insufficient Disk Space will be issued. The files
  4594.             reported as moved, were in fact moved.
  4595.    
  4596.    
  4597.    
  4598.    
  4599.    
  4600.    
  4601.    
  4602.    
  4603.                                       -72-    Obs Toolkit 1.5                                              MultiFile
  4604.    
  4605.         C>MF /M /R /I /H *.tmp .
  4606.           Move all the .TMP files beyond the current directory into the
  4607.           current directory and hoist them to parent level. Since the /I
  4608.           option was invoked, MultiFile will skip any .TMP files that are
  4609.           already in the current directory.
  4610.    
  4611.      DOS operational differences:
  4612.         MultiFile /Copy cannot be used to catenate files via wildcards.
  4613.         MultiFile will instead ask if the directory should be created. DOS
  4614.         would catenate all files into a single file.
  4615.    
  4616.         MultiFile /Copy does not support the "+" (catenation) operator when
  4617.         copying files.
  4618.    
  4619.         MultiFile /Copy does not support the /Ascii and /Binary
  4620.         qualifiers. Files are always copied as BINARY, and are identical to
  4621.         the source.
  4622.    
  4623.         MultiFile /Copy reports the filename after its is copied. In the
  4624.         event that there is insufficient disk space available on the target
  4625.         drive, then the filename is the file that was not copied.
  4626.    
  4627.         MultiFile generates an "Invalid filename" when the colon is used as
  4628.         a delimiter.
  4629.    
  4630.    
  4631.    
  4632.    
  4633.    
  4634.    
  4635.    
  4636.    
  4637.    
  4638.    
  4639.    
  4640.    
  4641.    
  4642.    
  4643.    
  4644.    
  4645.    
  4646.    
  4647.    
  4648.    
  4649.    
  4650.    
  4651.    
  4652.    
  4653.    
  4654.    
  4655.    
  4656.    
  4657.    
  4658.    
  4659.    
  4660.    
  4661.    
  4662.                                       -73-    Obs Toolkit 1.5                                                  ObsCD
  4663.    
  4664.                                   ObsCD (OCD)
  4665.                                   -----------
  4666.    
  4667.      Description:
  4668.         ObsCD (OCD) is a utility that allows you to move between directories
  4669.         with ease. CD was O.K. when a disk was only 5 meg, but now you
  4670.         probably have more than 100 meg of finely structured directories.
  4671.         Using a computer is hard enough, (really its easy), without having
  4672.         to remember exactly where you put everything.
  4673.    
  4674.         ObsCD maintains a HotDir file of directories on your disk(s) so that
  4675.         you can go there with one simple command.
  4676.    
  4677.         ObsCD uses sophisticated pattern matching logic, so that it tries
  4678.         very hard to figure out which directory you want to change to.
  4679.    
  4680.         ObsCD can Push and Pop directories. (A directory stack must be
  4681.         installed for these operations.)
  4682.    
  4683.         ObsCD limits its assumptions about how you want it to operate so
  4684.         there are options to configure its operation.
  4685.    
  4686.      Usage:
  4687.         OCD [options] [SmartPath][directory]
  4688.    
  4689.         If the directory name is preceded by an asterisk '*' (e.g.,
  4690.         *STRING), then a substring match will be performed. Any directory
  4691.         that contains the string which follows the asterisk will be
  4692.         selected. You can reissue the same command to go from the current
  4693.         directory to the next matching directory.
  4694.    
  4695.         If the directory name contains any question marks '?' (e.g.
  4696.         budget??), then only directory names that match the verbatim text
  4697.         exactly, and have place holders for the '?'s will be selected. Once
  4698.         again, you can reissue the same command to go from the current
  4699.         directory, to the next matching directory.
  4700.    
  4701.         You can select a fixed path by specifying the directory name like
  4702.         the following (CPROGS\LF). This will cause a fuzzy match on "CPROGS"
  4703.         but requires an absolute match on "LF". The concept can be extended
  4704.         further to include matches such as (TURBO\TC\CPROGS), will select
  4705.         that CPROGS directory over any other CPROGS directories. NOTE: The
  4706.         primary directory (e.g., CPROGS in the first example, and TURBO in
  4707.         the second) must be located in the HotDir file. If the directory is
  4708.         not in the HotDir file, or was excluded, then OCD will not be able
  4709.         to locate the directory.
  4710.    
  4711.      Options:
  4712.         /Basedisk - Drive letter of lowest hard drive in system
  4713.            Usage: OCD /BASEDISK drive
  4714.    
  4715.    
  4716.    
  4717.    
  4718.    
  4719.    
  4720.    
  4721.                                       -74-    Obs Toolkit 1.5                                                  ObsCD
  4722.    
  4723.            This option informs OCD that this system is not configured with
  4724.            the lowest hard drive as drive C:. The basedisk defaults to C:
  4725.            Use this option to inform OCD that the system has more than two
  4726.            floppies, or that the hard disk is drive B:
  4727.    
  4728.         /[NO]Change - Change to dir (default /NOCHANGE)
  4729.            Usage: OCD /MKDIR /CHANGE newdir
  4730.    
  4731.            This option directs OCD to change to the newly created directory.
  4732.            It is still necessary to use /DISK if you want the current
  4733.            location moved there across disks; otherwise, the current
  4734.            directory for the specified disk will be changed. Requires
  4735.            (/MKDIR) to create the directory.
  4736.    
  4737.         /[NO]DIsk - Allow a change of drives (default /NODISK)
  4738.            This option permits OCD to change disks when trying to satisfy
  4739.            your request for a directory. If this option is absent, OCD will
  4740.            not leave the current disk.
  4741.    
  4742.         /DRives - Use these drives during the /READ operation
  4743.            Usage: OCD /DRIVES drives [/READ | /LIST]
  4744.    
  4745.            The next parameter, after the option DRIVES, must be a collection
  4746.            of drive letters (e.g. ABCDEFG).
  4747.    
  4748.            Used with the READ command, /DRIVES restricts the drives that
  4749.            OCD will use during the read operation. This option is good for
  4750.            eliminating shadow disks, RAM disks, and network disks.
  4751.    
  4752.            Used with the LIST command, /DRIVES will only list the current
  4753.            working directory on the drives that you specify. This is good to
  4754.            eliminate disks which are only sometimes there.
  4755.    
  4756.            Note: This option will override the LAST drive.
  4757.    
  4758.         /[NO]ECho - Report the directory changed to (default /NOECHO)
  4759.            This will, upon every location change, echo to the console the
  4760.            directory that was selected, and changed to.
  4761.    
  4762.            TIP:
  4763.               Use OCD /ECHO if you don't keep your current working directory
  4764.               in your PROMPT. This option will enable you to determine your
  4765.               current location after the move without asking.
  4766.    
  4767.         /[NO]Force - Force the directory push (default /NOPUSH)
  4768.            This option will cause the PUSH to place the current directory
  4769.            onto the DirStack even if it would duplicate the top most entry.
  4770.            This option is useful in batch files, to ensure that you return
  4771.            the user to their originating position.
  4772.    
  4773.            This option requires PUSH.
  4774.    
  4775.    
  4776.    
  4777.    
  4778.    
  4779.    
  4780.                                       -75-    Obs Toolkit 1.5                                                  ObsCD
  4781.    
  4782.            TIP:
  4783.               When changing directories within batch files, be sure to
  4784.               restore the users original environment. ObsCD can help. Use
  4785.               the following procedure (a minimum DirStack of size 2 is
  4786.               required):
  4787.                 OCD /PUSH /FORCE
  4788.                 drive:
  4789.                 OCD /PUSH /FORCE \directory
  4790.                 REM invoke program
  4791.                 OCD /POP
  4792.                 OCD /POP
  4793.    
  4794.         /LAst - Do not consider drives beyond during the /READ operation
  4795.            Usage: OCD /LAST drive [/LIST | /READ]
  4796.    
  4797.            The next parameter, after LAST, must be a drive ID (e.g., F:).
  4798.            The colon is optional.
  4799.    
  4800.            Used with the READ command, this option causes all drives beyond
  4801.            the stated LAST drive to be ignored during the READ operation.
  4802.    
  4803.            Used with the LIST command, this option causes only the disks up
  4804.            to and including the LAST drive to have there current working
  4805.            directory reported.
  4806.    
  4807.            This is good for eliminating RAM disks, and SUBSTituted drives.
  4808.    
  4809.         /LIst - Report the directory stack and default directories
  4810.            This command allows you to List the DirStack. The entries will be
  4811.            numbered from top of stack (1:) to the bottom of stack (4:).
  4812.            These are the locations that you can POP to.
  4813.    
  4814.            In addition, this command also reports the current default
  4815.            directory for each hard-drive on your system. These directories
  4816.            can be used by all DOS software and most third party software
  4817.            (Obs Toolkit included) simply by specifying the Drive name (e.g.
  4818.            C:).
  4819.    
  4820.            Note:
  4821.               If the PUSH option is combined with LIST command then the
  4822.               PUSH will be ignored. Otherwise, the stack may have been
  4823.               modified when you requested a listing.
  4824.    
  4825.         /MKdir (MD) - Make directory
  4826.            Usage: OCD /MKDIR newdir
  4827.    
  4828.            This command allows you to make a new directory and update the
  4829.            HotDir file at the same time. If you want to change to the newly
  4830.            created directory use the CHANGE option also.
  4831.    
  4832.         /POp [n] - Return to a previously pushed directory.
  4833.            This command moves you to the 'n'th location on the stack.
  4834.    
  4835.            A DirStack must be installed for this option to be available.
  4836.    
  4837.    
  4838.    
  4839.                                       -76-    Obs Toolkit 1.5                                                  ObsCD
  4840.    
  4841.            Note:
  4842.               If the pop operation exceeds the stack depth, then a warning
  4843.               message will be displayed and no operation will occur.
  4844.    
  4845.         /[NO]PUsh - Push location onto stack (default /NOPUSH)
  4846.            Place the current disk and directory (location) onto the
  4847.            DirStack. If the current directory is already at the top of the
  4848.            DirStack, then it is not pushed. This is to conserve the precious
  4849.            DirStack space. Use FORCE to duplicate the DirStack top.
  4850.    
  4851.            If a directory is supplied, then push the current directory and
  4852.            change to the new directory.
  4853.    
  4854.            Note:
  4855.               If the PUSH option is combined with LIST then the PUSH will be
  4856.               ignored.
  4857.    
  4858.               The default DirStack is four (4) locations deep, but this can
  4859.               be specified when installing ObsRes.
  4860.    
  4861.               Whenever the stack overflows on a push, then the bottom of the
  4862.               stack (oldest entry) will be pushed off without warning.
  4863.    
  4864.         /REad - Read the HotDir file
  4865.            OCD uses a Hot Directory file, which it places on your basedisk
  4866.            drive. Refer to BASEDISK for information on the basedisk. Floppy
  4867.            disks are supported by HotDirs always.
  4868.    
  4869.            This command creates the Hot Directory file on the lowest
  4870.            addressable hard drive (usually C:). The filename is OBSCD.NDX.
  4871.            You cannot issue a READ command on a drive less that the
  4872.            BASEDISK.
  4873.    
  4874.            In order to quickly determine which directory you want to go to,
  4875.            this file is consulted. OCD will function without this file, but
  4876.            Hot Directories will not be supported.
  4877.    
  4878.            This command may take a short while.
  4879.    
  4880.            This file must be explicitly created.
  4881.    
  4882.         /RMdir (RD) - Remove directory
  4883.            Usage: OCD /RMDIR emptydir
  4884.    
  4885.            This command instructs OCD to remove a directory and eliminate it
  4886.            from the HotDir file.
  4887.    
  4888.         /[NO]SCan - Scan disk for directory (default /NOSCAN)
  4889.            This option allows HotDir capability on a disk/directory that was
  4890.            previously eXcluded. The information is not stored in the HotDir
  4891.            file.
  4892.    
  4893.    
  4894.    
  4895.    
  4896.    
  4897.    
  4898.                                       -77-    Obs Toolkit 1.5                                                  ObsCD
  4899.    
  4900.         /STack - Place the specified directory onto the stack
  4901.            This command allows you to place the specified directory onto the
  4902.            DirStack without changing into it. Nothing else is disturbed.
  4903.    
  4904.            Use the DISK option to stack a directory from another disk.
  4905.    
  4906.            Use the ECHO option to report the directory stacked.
  4907.    
  4908.         /UP [n] - Move UP the path
  4909.            This command moves you up 'n' sub-directories from the current
  4910.            path.
  4911.    
  4912.         /[NO]UPDate - OK to update the HotDir file (default /UPDATE)
  4913.            This option maintains the HotDir file on the fly, without
  4914.            performing a READ operation. Use of this option is must faster
  4915.            than re-reading the entire directory structure.
  4916.    
  4917.            When changing to a directory that was deleted, this option
  4918.            removes the deleted directory from the HotDir file.
  4919.    
  4920.            When changing from a directory that does not exist in the HotDir
  4921.            file, this option adds the current directory, and its parents if
  4922.            necessary, to the HotDir file.
  4923.    
  4924.            This option is provided so that you can easily update the HotDir
  4925.            file after using a third party software installation, that
  4926.            created its own directories, or after a cleanup that moved or
  4927.            deleted directories.
  4928.    
  4929.            TIP:
  4930.               If you allow OCD to UPDATE the HotDir file will remain fairly
  4931.               much up-to-date, without ever having to resort to a READ
  4932.               operation.
  4933.    
  4934.         /eXclude - Exclude directory from the HotDir file
  4935.            Usage: OCD /READ { /EXCLUDE dirname }
  4936.    
  4937.            This READ option permits disk branches to be eliminated from the
  4938.            HotDir file. Once a branch has been eliminated, it will not be
  4939.            updated. Up to 8 excluded branches may be specified.
  4940.    
  4941.            This option requires the READ command.
  4942.    
  4943.            Note:
  4944.               To add the branch back into the HotDir file a READ operation
  4945.               must be performed.
  4946.    
  4947.      TIPS:
  4948.         If you use a basedisk other that C:, then use recursive aliases and
  4949.         define OCD to be OCD /BASEDISK ?: where ? is your lowest addressable
  4950.         hard drive (e.g., ALIAS ocd OCD /BASEDISK D:). This will ensure that
  4951.         OCD always uses the correct basedisk.
  4952.    
  4953.    
  4954.    
  4955.    
  4956.    
  4957.                                       -78-    Obs Toolkit 1.5                                                  ObsCD
  4958.    
  4959.         Define the following commands:
  4960.            C>ALIAS cd OCD /PUSH
  4961.              This will operate like DOS's CD, but will stack Hot Directories
  4962.              and enable returns.
  4963.    
  4964.            C>ALIAS cdd OCD /DISK /PUSH
  4965.              This will allow you to change directories and disks with CDD.
  4966.    
  4967.            C>ALIAS sw OCD /PUSH /POP
  4968.              This will allow you to switch between the current directory and
  4969.              the directory on the top of the DirStack.
  4970.    
  4971.            C>ALIAS md OCD /MKDIR
  4972.            C>ALIAS rd OCD /RMDIR
  4973.              These commands will update the HotDir file whenever you create
  4974.              or remove a directory.
  4975.    
  4976.            C>ALIAS pop OCD /POP
  4977.              This will allow you to move back to a previous location.
  4978.    
  4979.            C>ALIAS up OCD /PUSH /UP
  4980.              This will allow you to move up the directory branch.
  4981.    
  4982.            C>ALIAS list OCD /LIST
  4983.               This will allow you to list the current DirStack, and default
  4984.               directories.
  4985.    
  4986.               When using the directory stack with MultiFile and ListFiles,
  4987.               you can easily determine which SmartPath that you want to
  4988.               reference.
  4989.    
  4990.         Use recursive aliases, and define OCD to be OCD /UPDATE. This will
  4991.         enable ObsCD to update the HotDir file whenever it detects that a
  4992.         new directory was created, or an existing directory was deleted.
  4993.    
  4994.         Use a prompt that contains the directory pathname, or direct OCD to
  4995.         echo (OCD /ECHO) its actions. If you don't you may not know where
  4996.         you are.
  4997.    
  4998.            C>prompt $p$g - The prompt will tell you where you are at all
  4999.                            times.
  5000.    
  5001.      Examples:
  5002.         C>OCD
  5003.           This will report the current directory.
  5004.    
  5005.         C>OCD f:\util
  5006.           This will change the current directory on the F: drive to the
  5007.           \UTIL directory, but leave you at the same place.
  5008.    
  5009.         C>OCD /PUSH /DISK f:\util
  5010.           This will change to the util directory on the F: drive.
  5011.    
  5012.    
  5013.    
  5014.    
  5015.    
  5016.                                       -79-    Obs Toolkit 1.5                                                  ObsCD
  5017.    
  5018.         C>OCD /POP
  5019.           This will return you to the previous pushed directory.
  5020.    
  5021.         C>OCD /PUSH /POP
  5022.           This will save the current location on the stack and move you to
  5023.           the current stack top. This allows you to switch back and forth
  5024.           between two directories.
  5025.    
  5026.         C>OCD d:
  5027.           This will report the current directory on the D: drive.
  5028.    
  5029.         C>OCD /DISK 3:
  5030.           This will change to the directory which is 3 on the DirStack.
  5031.    
  5032.         C>OCD /READ /LAST e:
  5033.           This will read a new HotDir file for drives CDE if present. If
  5034.           drives are present above E:, then they will be ignored.
  5035.    
  5036.         C>OCD /READ /DRIVES cf /EXCLUDE c:\ignore
  5037.           This will read a new HotDir file for drives C and F only. The
  5038.           branch C:\IGNORE will be completely ignored.
  5039.    
  5040.         C>OCD /MKDIR /CHANGE newdir
  5041.           This instructs OCD to create the directory NEWDIR and then set it
  5042.           to be the default dir. If the directory was created on a different
  5043.           drive, then the default directory for that drive will be changed.
  5044.           If the DISK option was also specified, then the current working
  5045.           disk and directory would be changed.
  5046.    
  5047.         C>OCD /UP 2
  5048.           If the current path is C:\root\sub1\sub2\sub3 this command would
  5049.           move you to C:\root\sub1.
  5050.    
  5051.         C>OCD /STACK /DISK /ECHO util
  5052.           Place UTIL onto the DirStack. Get the UTIL from the best matching
  5053.           drive and echo to the console the name of the disk:\directory that
  5054.           was placed onto the stack.
  5055.    
  5056.      Notes:
  5057.         When you specify a disk and Hot Directory, OCD will select the best
  5058.         matching directory on the specified disk.
  5059.    
  5060.         Absolute & relative path names are supported at all times.
  5061.    
  5062.         The DirStack depth can be set when ObsRes or DirStack is installed.
  5063.    
  5064.         Hot Directory searches always start from the current location. This
  5065.         means that if there are two (2) or more directories with the same
  5066.         match weight, then you can re-execute the same command to move along
  5067.         to the next directory.
  5068.    
  5069.    
  5070.    
  5071.    
  5072.    
  5073.    
  5074.    
  5075.                                       -80-    Obs Toolkit 1.5                            Appendix A: Quick Reference
  5076.    
  5077.    ------------------------------------------------------------------------
  5078.                                      Alias
  5079.    ------------------------------------------------------------------------
  5080.    Usage:
  5081.      alias [/[NO]Page] [name]    - Report synonym(s) (wildspecs supported)
  5082.      alias [/NOSpace]   name cmd - Define synonym    (abbreviate using "'")
  5083.      alias /NUll        name     - Define null synonym
  5084.      alias /Make        name     - Define a path alias
  5085.      alias /EDit        name     - Edit alias definition
  5086.      alias /CLear                - Remove ALL synonyms
  5087.      alias /Delete      name     - Remove synonym
  5088.      alias /File        file.ext - Read alias commands from file.ext
  5089.    
  5090.      alias [options] - (configures/info on the translator; may be combined)
  5091.         /[NO]CAse    - Case sensitive aliases
  5092.         /[NO]ECho    - Echo translations
  5093.         /[NO]Recurse - Recursively apply aliases
  5094.         /OFf         - Turn translator Off
  5095.         /ON          - Turn translator On
  5096.         /STatus      - Report active conditions
  5097.         /SKipchar x  - Define character to skip translation
  5098.    
  5099.    
  5100.    
  5101.    
  5102.    
  5103.    ------------------------------------------------------------------------
  5104.                                     DirSize
  5105.    ------------------------------------------------------------------------
  5106.    Usage: DS [options] [path]
  5107.    Options are:
  5108.       /BYDAte     - Sort tree in date order
  5109.       /BYDOs      * No tree sort
  5110.       /BYName     - Sort tree in alphabetical order
  5111.       /BYSize     - Sort tree from smallest to largest
  5112.       /DEpth num  - Draw tree to depth 'num'
  5113.       /[NO]Count  - Continue to count files
  5114.       /[NO]DAte   - Display creation date
  5115.       /[NO]Page   - Page output
  5116.       /[NO]Size   + Display sizes
  5117.    
  5118.    
  5119.    
  5120.    
  5121.    
  5122.    
  5123.    
  5124.    
  5125.    
  5126.    
  5127.    
  5128.    
  5129.    
  5130.    
  5131.    
  5132.    
  5133.    
  5134.                                       -81-    Obs Toolkit 1.5                            Appendix A: Quick Reference
  5135.    
  5136.    ------------------------------------------------------------------------
  5137.                                     EnvEdit
  5138.    ------------------------------------------------------------------------
  5139.    Usage: EE [options] [variable[=[definition]]]
  5140.    Options are:
  5141.       /CUrrent    - Use the Current environment
  5142.       /DOs        * Use the active DOS environment
  5143.       /MASter     - Use the Master environment (aka /ROot)
  5144.       /Parent     - Use the Parent environment
  5145.    
  5146.       /[NO]CAse   - Name is case sensitive
  5147.       /[NO]Edit   - Permits usage of the line editor
  5148.       /[NO]STatus - Report status on the environment
  5149.       /[NO]REMove + Remove variable on "VAR="
  5150.       /[NO]Quiet  - No display output
  5151.    
  5152.       /Append     - Append "text" to end of definition
  5153.       /INSert     - Insert "text" to beginning of definition
  5154.       /REPlace    - Replace "text_1" with "text_2" in definition
  5155.    
  5156.       /COpy       - Duplicate environment variable
  5157.       /DELete     - Delete environment variable
  5158.       /MAKe       - Define a variable to be the current directory
  5159.       /REName     - Rename environment variable
  5160.    
  5161.       /INCrement  - Add one to the variable
  5162.       /DECrement  - Subtract one from the variable
  5163.       /Upper      - Change definition to all upper case
  5164.       /LOWer      - Change definition to all lower case
  5165.    
  5166.       /CLear      - Clear the environment
  5167.       /LOAd       - Load DOS environment from file
  5168.       /SAve       - Store environment into file
  5169.    
  5170.    
  5171.    
  5172.    
  5173.    
  5174.    
  5175.    
  5176.    
  5177.    
  5178.    
  5179.    
  5180.    
  5181.    
  5182.    
  5183.    
  5184.    
  5185.    
  5186.    
  5187.    
  5188.    
  5189.    
  5190.    
  5191.    
  5192.    
  5193.                                       -82-    Obs Toolkit 1.5                            Appendix A: Quick Reference
  5194.    
  5195.    ------------------------------------------------------------------------
  5196.                                    FileDump
  5197.    ------------------------------------------------------------------------
  5198.    Usage: FD [options] {[SmartPath][directory]WildSpec}
  5199.    Options are:
  5200.      /Ascii        - Ascii output
  5201.      /COUnt        - Count chars, words, lines, and pages
  5202.      /Hex          - Hex output
  5203.      /TExt         * Text output
  5204.      /STrings #    - String output (# is minimum string length)
  5205.    
  5206.      /BInary       - Force input to be binary
  5207.      /BEgin   #[x] - Start offset
  5208.      /End     #[x] - End offset
  5209.      /TAb     #    - Set tab setting (normally 8)
  5210.      /7            - Strip high bit
  5211.      /8            * Do not strip high bit
  5212.    
  5213.      /[NO]COMpress - Compress runs
  5214.      /[NO]NUmber   - Number lines (/TEXT only)
  5215.      /[NO]Page     - Page output
  5216.      /[NO]SMart    - Smart type logic
  5217.      /[NO]Wrap     + Wrap long lines
  5218.    
  5219.    
  5220.    
  5221.    
  5222.    
  5223.    ------------------------------------------------------------------------
  5224.                                    ListFiles
  5225.    ------------------------------------------------------------------------
  5226.    Usage: LF [options] [SmartPath][directory]{WildSpec}
  5227.    Options are: (/-x for B C G L O P R W X)
  5228.       1  - 12 hour clock;  2 - 24 hour clock
  5229.       Ax - Attribute
  5230.          A - Archive, H - Hidden,  R - Read-only, S - System, D - Directory
  5231.          + - include, - - exclude, * - required
  5232.       Bx - Brief output (B+ for full pathnames)
  5233.       Cx - Command listing (B - Beginning, E - End, T - Text)
  5234.       Dx - Detect special conditions
  5235.          C - duplicate Contents  D - Duplicate entry,
  5236.          H - Hidden programs     O - Old files
  5237.       G  - report Grand total information only
  5238.       L  - Lower case
  5239.       Ox - Order by (-x to reverse)
  5240.          U - Unsorted,  E - by Extension, N - by Name, G - Group directories
  5241.          S - by Size,   D - by Date/time, R - Reverse output
  5242.       P  - Page output
  5243.       R  - Recurse Sub-directories
  5244.       Sx - Size restriction (L - Less-than, E - Equal,  G - Greater than)
  5245.       Tx - Time restriction (B - Before,    E - Exact,  S - Since)
  5246.       Wx - Wide output (x is number of columns (1-5))
  5247.       Xx - Exclude WildSpec (may be repeated)
  5248.    
  5249.    
  5250.    
  5251.    
  5252.                                       -83-    Obs Toolkit 1.5                            Appendix A: Quick Reference
  5253.    
  5254.    ------------------------------------------------------------------------
  5255.                                     Locate
  5256.    ------------------------------------------------------------------------
  5257.    Usage: LOCATE [options] {disk} [name]
  5258.    Options are:
  5259.       /COmmand    * Search for a command
  5260.       /FIle       - Search for a file
  5261.    
  5262.       /[NO]All    - Include system and hidden files (/File only)
  5263.       /[NO]CHange - Change to directory where /COMMAND was found
  5264.       /[NO]FUll   - Display all file information for commands
  5265.       /[NO]Page   - Page output
  5266.       /[NO]Wide   - Wide output
  5267.    
  5268.    
  5269.    
  5270.    
  5271.    
  5272.    
  5273.    ------------------------------------------------------------------------
  5274.                                    MultiFile
  5275.    ------------------------------------------------------------------------
  5276.    Usage: MF [options] [SmartPath]WildSpec [SmartPath][filespec]
  5277.    Options are: (-x cancels ! H I F P N Q R V X Y)
  5278.       C   - Copy all files                 CU  - Update existing files
  5279.       CR  - Replace existing files         CA  - Add new files
  5280.       CAR - Add & Replace (like DOS)       CUA - Update & Add
  5281.       D   - Delete                         M   - Move/Rename
  5282.       SAx - Set Attributes                 STx - Set file date & Time
  5283.    
  5284.       Ax  - Attribute selection
  5285.           A - archive,  H - hidden,  R - read-only,  S - system
  5286.           + - include,  - - exclude, * - required
  5287.       I   - Ignore overwrites by skipping file
  5288.       N   - Select archive files, reset after copy (copy only)
  5289.       Tx  - Time restrictions (B - Before,  E - Exact,  S - Since)
  5290.       Xx  - Exclude WildSpec (may be repeated)
  5291.    
  5292.       !   - Test run, perform no actions   H   - Hoist to target / flatten tree
  5293.       F   - Force all operations           P   - Prompt at each file
  5294.       Q   - Quiet operations               R   - Recurse Sub-directories
  5295.       V   - Verify writes                  Y   - Yes to cautions
  5296.    
  5297.    
  5298.    
  5299.    
  5300.    
  5301.    
  5302.    
  5303.    
  5304.    
  5305.    
  5306.    
  5307.    
  5308.    
  5309.    
  5310.    
  5311.                                       -84-    Obs Toolkit 1.5                            Appendix A: Quick Reference
  5312.    
  5313.    ------------------------------------------------------------------------
  5314.                                      ObsCD
  5315.    ------------------------------------------------------------------------
  5316.    Usage: OCD [options] [SmartPath][dirname]
  5317.    Options are:
  5318.       /LIst        - List the DirStack and default dirs
  5319.       /MKdir       - Make directory (MD)
  5320.       /POp [n]     - Restores a pushed location   (default=1)
  5321.       /REad        - Read a new HotDir file
  5322.       /RMdir       - Remove directory (RD)
  5323.       /STack       - Put the specified directory on the DirStack
  5324.       /UP  [n]     - Moves up 'n' directories     (default=1)
  5325.    
  5326.       /DRives      - Drives to /READ or /LIST
  5327.       /LAst        - Last drive to scan during /READ or /LIST
  5328.       /eXclude     - Exclude directory from /READ
  5329.    
  5330.       /Basedisk    - Lowest hard drive letter     (default 'C:')
  5331.       /[NO]Change  - Change into directory during /MKDIR
  5332.       /[NO]DIsk    - Allows disk changes
  5333.       /[NO]ECho    - Reports directory changed to
  5334.       /[NO]Force   - Force push (no duplicate check)
  5335.       /[NO]PUsh    - Saves current location to the DirStack
  5336.       /[NO]SCan    - Force scan for directory change
  5337.       /[NO]UPDate  + OK to update the HotDir file
  5338.    
  5339.    
  5340.    
  5341.    
  5342.    
  5343.    
  5344.    
  5345.    
  5346.    
  5347.    
  5348.    
  5349.    
  5350.    
  5351.    
  5352.    
  5353.    
  5354.    
  5355.    
  5356.    
  5357.    
  5358.    
  5359.    
  5360.    
  5361.    
  5362.    
  5363.    
  5364.    
  5365.    
  5366.    
  5367.    
  5368.    
  5369.    
  5370.                                       -85-    Obs Toolkit 1.5                            Appendix A: Quick Reference
  5371.    
  5372.    WildSpecs
  5373.    ---------
  5374.      ? - matches any single character    (a character is required)
  5375.      * - matches any group of characters (zero or more characters may match)
  5376.    
  5377.    SmartPaths
  5378.    ----------
  5379.      OCD /LIST    (Reports contents of DirStack)
  5380.    
  5381.      SmartPaths work just like regular drives. You can also OCD /POP back.
  5382.    
  5383.      You cannot reference the root of a SmartPath.
  5384.    
  5385.    Date and Time
  5386.    -------------
  5387.      "Date Time" (Quotes required to supply both Date & Time)
  5388.         date = mm-dd-yy - the full date must be specified
  5389.         date = -days    - that many days in the past
  5390.    
  5391.         time = hh:mm:ss - the minutes & seconds are optional
  5392.         time = .        - this translates to the current time
  5393.    
  5394.    Quoting Strings
  5395.    ---------------
  5396.      To insert a quote into a quoted string, prepend with a single backslash
  5397.    
  5398.    Line Editor
  5399.    -----------
  5400.      Up Arrow       Move one line up (multiple line display only)
  5401.      Down Arrow     Move one line down (multiple line display only)
  5402.      Left Arrow     Move one character to the left
  5403.      Right Arrow    Move one character to the right
  5404.      CTRL-Left      Move one word to the left
  5405.      CTRL-Right     Move one word to the right
  5406.      INSERT         Toggle Insert/Overstrike mode
  5407.      HOME     (^A)  Move to the beginning of the edit field
  5408.      END      (^E)  Move to the end of the edit field
  5409.      DELETE   (^D)  Delete the current character
  5410.      BACKSPACE      Delete the previous character
  5411.      CTRL-Y         Delete the entire line
  5412.      RETURN (ALT-X) Store changes and exit
  5413.      ESCAPE         Abort changes and exit
  5414.    
  5415.    Error Levels
  5416.    ------------
  5417.      0 - NO ERROR         - No error encountered
  5418.      1 - NOT FOUND        - File or object was "NOT FOUND"
  5419.      2 - ABORTED          - The user chose to "ABORT" the operation
  5420.      3 - OPERATION FAILED - The requested "OPERATION FAILED"
  5421.      4 - LIMIT EXCEEDED   - The operation exceeded the tools "LIMIT"
  5422.      5 - USAGE ERROR      - The tool displayed a "USAGE" error
  5423.      6 - INSTALL FAILED   - The tool was unable to "INSTALL"
  5424.    
  5425.    
  5426.    
  5427.    
  5428.    
  5429.                                       -86-    Obs Toolkit 1.5                                 Appendix B: Bug Report
  5430.    
  5431.    If you think that you have found a bug, then please do the following:
  5432.    
  5433.       Read the documentation carefully, see if it is a misunderstanding.
  5434.    
  5435.    
  5436.    
  5437.                If it isn't a misunderstanding, it must be a bug!
  5438.    
  5439.    
  5440.    Date?  __/__/__     Name? _______________________   Phone? (___) ___-____
  5441.    
  5442.    Are you registered?  Yes / No
  5443.    
  5444.    
  5445.                              Describe the problem?
  5446.    
  5447.    
  5448.    Classify the problem?       Minor    Inconvenient    Destructive
  5449.    
  5450.    Can you reproduce the problem?  Yes / No
  5451.    
  5452.    Describe your environment? _____________________________________________
  5453.    
  5454.    ________________________________________________________________________
  5455.    
  5456.    ________________________________________________________________________
  5457.    
  5458.    Which tool? ____________________________________________________________
  5459.    
  5460.    Exact syntax of the command?____________________________________________
  5461.    
  5462.    What did you expect to happen? _________________________________________
  5463.    
  5464.    ________________________________________________________________________
  5465.    
  5466.    ________________________________________________________________________
  5467.    
  5468.    What, in fact, happened? _______________________________________________
  5469.    
  5470.    ________________________________________________________________________
  5471.    
  5472.    ________________________________________________________________________
  5473.    
  5474.    Additional comments? ___________________________________________________
  5475.    
  5476.    ________________________________________________________________________
  5477.    
  5478.    ________________________________________________________________________
  5479.    
  5480.    ________________________________________________________________________
  5481.    
  5482.    ________________________________________________________________________
  5483.    
  5484.    ________________________________________________________________________
  5485.    
  5486.    
  5487.    
  5488.                                       -87-    Obs Toolkit 1.5                                Appendix C: Survey Form
  5489.    
  5490.                                    Mail to:
  5491.    
  5492.                                 Contrails, Inc.
  5493.                                  P.O. Box 2759
  5494.                              Lompoc, CA 93438-2759
  5495.    
  5496.    
  5497.    Please take the time to tell us what you think. Your feedback will help
  5498.    us to develop better products and marketing techniques.
  5499.    
  5500.    How did you learn about Obs Toolkit? ____________________________________
  5501.    
  5502.    Where did you get this copy?         ____________________________________
  5503.    
  5504.    When did you start your evaluation?  __/__/__  (Be honest)
  5505.    
  5506.    Are you going to/did you register?   Yes / No
  5507.    
  5508.    Will you share it with a friend?     Yes / No
  5509.    
  5510.    How does Obs Toolkit rate?
  5511.       Quality            Poor   Needs-Improvement  Good   Excellent
  5512.       Reliability        Poor   Needs-Improvement  Good   Excellent
  5513.       Ease of use        Poor   Needs-Improvement  Good   Excellent
  5514.       Features           Poor   Needs-Improvement  Good   Excellent
  5515.       Expandability      Poor   Needs-Improvement  Good   Excellent
  5516.       Documentation      Poor   Needs-Improvement  Good   Excellent
  5517.    
  5518.    
  5519.    What other tools do you use on a regular basis?  ________________________
  5520.    
  5521.    _______________________ ________________________ ________________________
  5522.    
  5523.    _______________________ ________________________ ________________________
  5524.    
  5525.    _______________________ ________________________ ________________________
  5526.    
  5527.    
  5528.    What can we do to improve Obs Toolkit? __________________________________
  5529.    
  5530.    _________________________________________________________________________
  5531.    
  5532.    _________________________________________________________________________
  5533.    
  5534.    _________________________________________________________________________
  5535.    
  5536.    _________________________________________________________________________
  5537.    
  5538.    
  5539.    What impressed you the most? ____________________________________________
  5540.    
  5541.    _________________________________________________________________________
  5542.    
  5543.    _________________________________________________________________________
  5544.    
  5545.    
  5546.    
  5547.                                       -88-    Obs Toolkit 1.5                          Appendix D: Registration Form
  5548.    
  5549.                             Make checks payable to:
  5550.    
  5551.                                 Contrails, Inc.
  5552.                                  P.O. Box 2759
  5553.                              Lompoc, CA 93438-2759
  5554.    
  5555.                                 (805) 733-2808
  5556.    
  5557.    
  5558.    
  5559.           Custom agreements (for orders over 100) are also available.
  5560.    
  5561.    
  5562.    Number of copies (one disk supplied)         Count     $/Copy   Total
  5563.    
  5564.       1 ...............................................    39.00 $ _______
  5565.    
  5566.       2  to   9 .............................   _____ @    28.00 $ _______
  5567.    
  5568.       10 to  24 .............................   _____ @    24.00 $ _______
  5569.    
  5570.       25 to  49 .............................   _____ @    21.00 $ _______
  5571.    
  5572.       50 to 100 .............................   _____ @    19.00 $ _______
  5573.    
  5574.       Additional manuals (order includes 1)..   _____ @     6.00 $ _______
  5575.    
  5576.                                                        Sub-Total $ _______
  5577.    
  5578.             California residents, please include 7.75% sales tax $ _______
  5579.    
  5580.      Shipping and handling ($4.00 + $1.00 per additional manual) $ _______
  5581.    
  5582.                                                            Total $ _______
  5583.    
  5584.    
  5585.    Date of order: __/__/__  Payment by:  ( ) Check         ( ) Money Order
  5586.    
  5587.                             Disk size:   ( ) 5 1/4 inch    ( ) 3 1/2 inch
  5588.    
  5589.    
  5590.                                  Register to:
  5591.    
  5592.          Name: _____________________________________ Phone: (___) ___-____
  5593.    
  5594.       Company: _____________________________________   Fax: (___) ___-____
  5595.    
  5596.       Address: ___________________________________________________________
  5597.    
  5598.                ___________________________________________________________
  5599.    
  5600.                State: __     Zip Code: ______-____
  5601.    
  5602.                      Please allow 2-3 weeks for delivery.
  5603.    
  5604.    
  5605.    
  5606.                                       -89-